编写/维护规范文档的最简单方法是什么？

Question

我在一家初创公司工作，其中文档的优先级最低。我得到的理由是，初创公司通常不会在文档和操作方法上投入大量时间。因此，在每个项目开始时，我只有很少的时间来记录我将要编写的系统的特性/规范/行为。

在大多数情况下，即使我准备了一个初始文档，在开发过程中，需求也在不断变化，系统的行为也会发生轻微的变化。此外，我在一家基于产品的公司工作，因此我们提出了自己的需求，这肯定会在开发过程中经历一些变化。

所以我的问题是，系统规范/行为的最简单的可能表示是什么？我如何才能轻松地编写并定期更新它，而不花费太多的时间(在其中编写大量的代码行)？

Answer 1

当你有一个固定的项目生命周期时，需求规范就更有意义了。您所描述的听起来很像一个迭代的项目生命周期，而敏捷项目管理更适合它。在敏捷项目管理中，需求作为用户案例进行管理。用户故事是以这种格式描述需求的一种简单方式：

作为(角色)我想要(某物)以便(受益)

例如，对于购物车应用程序，一个用户故事可以是：

作为注册用户，我想要将列出的产品添加到购物车中，以便可以订购。

在每次迭代中，您可以返回查看是否需要添加新的用户故事或修改现有的用户故事。首先，您可以将用户故事保存在电子表格中(每行一个)，但还有许多其他高级敏捷pm包可供在线和离线使用。