我见过不同的程序经理用不同的格式编写规范.几乎每个人都有他/她自己的写作规范的风格.
一方面,给程序员的那些冗长的文件可能会导致他/她遗漏一些东西.我个人害怕文件规格这个词...我认为这是因为我的阅读风格......我总是快速阅读我认为会让我错过关键点的事情.
另一方面,我已经看到了我们的一个客户用Excel编写的这些创新规范.他以前编写规范的方式是在Excel中创建一个模拟应用程序并使用一些VBA来模拟它.他会做一些事情,比如按钮点击表单应该去哪里或应该执行什么操作(在评论中).
在数据表格中,他将在单元格和每个数据输入单元格中显示一个表单,他将评论哪些有效值,它应执行的验证等.
我认为使用这种技术,不太可能错过需要完成的事情.此外,为开发人员进行单元测试要容易得多.测试人员在实际编写之前"执行"时对系统有了更好的理解.
Visio是另一种进行屏幕设计的工具,但考虑到VBA支持及其功能,我仍然认为Excel具有更好的优势.
你认为这应该成为一种更流行的编写规范的方式吗?我知道这涉及到项目经理(或编写规范的人)的一些额外工作,但收益很大......我自己可以看到使用它可以获得很多生产力.如果有更好的规格格式,实际上可以帮助程序员.
Joel on Software特别擅长这些,并且有一些关于这个主题的好文章......
具体案例