编写项目规范时要避免的陷阱

Question

我目前正试图为一个大型的ish项目编写一些软件规格，我想在oDesk上投标(可能是3k-6k)。我受过计算机科学方面的经典教育，但工作经验很少，我从未在企业环境中工作过。

我已经为我想在上运行的API编写了15页的项目规范。我发现一些问题的微妙之处很难解决，例如:在哪里划定具体的内容和不指定哪些内容；如何将项目分解成几个部分，以便如果其中一个部分出错，其他部分仍然可以使用；在哪里以及如何设置里程碑；以及如何筛选具有正确实现规范的技能的候选人。

我问一个朋友我应该注意什么问题，他说：

确保规范没有矛盾的information

• Make确定规范不是不必要的特定，因为这将使更熟练的开发人员

关闭。

在制定项目规范时，我还应该注意哪些其他的缺陷和常见的错误？

Answer 1

虽然关注您想要实现的功能是很重要的，但是也要记住非功能性的需求。考虑一下您希望它如何执行、安全性考虑等。

Answer 2

其中一个要添加到列表中

• 确保规范是明确的。(只能解释一个way...Hopefully)

Answer 3

我认为这两个环节会有帮助：

关于Reqs和Specs：http://www.pragmaticmarketing.com/publications/topics/02/0204sj

无痛功能规范.第2部分:规范是什么？：http://www.joelonsoftware.com/articles/fog0000000035.html