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

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

我已经为一个我想在Google App Engine上运行的API编写了15页的项目规范。我发现一些微妙的问题很难解决，比如：在哪里划清界限，指定什么，不指定什么；如何将项目分解成若干部分，以便在一个部分出错时，其他部分仍可使用；在何处以及如何设定里程碑；以及如何筛选具备适当实施规范技能的候选人

我问一位朋友我应该注意哪些问题，他说：

• 确保规范中没有相互矛盾的信息
• 请确保规范没有不必要的特定性，因为这会让更熟练的开发人员望而却步

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

要添加到列表中的一个

• 确保规格明确无误。（只能用一种方式解释……希望如此）

---

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

我认为以下两个链接会有所帮助：

关于需求和规格：

---

无痛功能规范-第2部分：什么是规范？：

我认为API不会有太多准确和最新的文档。