Project management 如何编写高效的规范？

我见过不同的程序经理以不同的格式编写规范。几乎每个人都有自己编写规范的风格

一方面，给程序员的那些冗长的文档可能会导致他/她遗漏一些东西。我个人害怕文档规范这个词…我想这是因为我的阅读风格…我总是快速阅读我认为会导致我错过关键点的东西

另一方面，我看到我们的一位客户用Excel编写了这一创新规范。他编写规范的方式是在Excel中创建一个模拟应用程序，并使用一些VBA来模拟它。他会做一些事情，比如点击按钮，表单应该去哪里，或者它应该执行什么操作（在注释中）

在数据表单上，他会在单元格中显示一个表单，在每个数据输入单元格中，他会评论什么是有效值，应该执行什么样的验证等

我认为使用这种技术，不太可能错过需要做的事情。此外，对开发人员进行单元测试也容易得多。测试人员在实际编写之前对系统的“执行”也有了更好的理解

Visio是另一个进行屏幕设计的工具，但考虑到其VBA支持和功能，我仍然认为Excel比它有更好的优势

---

你认为这应该成为一种更流行的编写规范的方式吗？我知道这涉及到项目经理（或编写规范的人）的一些额外工作，但回报是巨大的……我自己也可以看到使用它可以提高很多生产率。如果有更好的规范格式可以帮助程序员的话。

微软出版社的一本书中有各种文档的优秀示例，包括SRS（我想这就是你所说的）。这可能是Weigert的一本需求书（我想那是他的名字，我现在正在空白处）。我见过美国政府机构将其作为模板，从我在政府的三次工作经历来看，他们喜欢尽可能地自己制作，因此如果他们正在重用它，那一定很好

另外，在我看来，规范不应该包含任何代码。它应该关注使用文本和图表系统必须做、应该做和不能做的事情。

特别擅长这些，并且有一些关于这个主题的好文章

---

我想您可以看看测试驱动需求，这是一种制作可执行规范的技术

---

有一些很棒的工具，比如，或就是为了达到这个目的。

有两种方法对我很有效

一个是你在问题中描述的“工作原型”。根据我的经验，该公司聘请了一位用户界面专家来创建功能齐全的HTML模拟。页面上的数据是静态的，但它允许开发人员和管理人员查看和使用该站点的“功能”版本。剩下要做的就是用动态内容替换页面上的静态数据——这个原型是我们产品初始版本的规范。设计师甚至在弹出对话框中详细解释了一些微妙的行为，当鼠标悬停在模拟链接上时会出现这些对话框。这对我们的团队很有效

在随后的一个项目中，我们没有UI专家这样的奢侈，但我们使用了类似的方法。我们使用wiki来模拟网站的一个版本。我们在系统的功能方面之间创建了链接，并详细记录了每一项功能。反过来，每一项功能都可以链接到详细的设计和体系结构决策。我们还使用wiki来保存每个版本的to list功能列表（这成为了我们的发行说明）。这些文档链接回详细功能页。维基变成了一个活生生的文档——非常详细地描述了我们发布的版本和系统的演变。这是一种宝贵的资源

---

与工作原型相比，我更喜欢wiki，因为它更容易扩展—随着系统的发展，它会不断增长，变得更有价值。

这个问题似乎离题了，因为项目管理问题不再是主题。看，我投票结束这个问题，因为它是关于项目管理的。