论软件项目需求文档的撰写

大多数工程师在撰写需求文档的时候，主要考虑的是如何把逻辑讲清楚。这实际上是从自身出发的一种思维模式。所谓的讲清楚，是自己认为讲清楚了，因为自己本身已经有一定的认识，所以只要写下来的是对的，那都属于讲清楚了的范畴。但自己认为得讲清楚未必等于读者的讲清楚了，读者由于原来对该事物没有认识，或者虽有认识但有些偏差，因而，当读者通过文档收获的东西不完全等于写者想表达的所有内容时，就不能定义为讲清楚了。笔者建议，在撰写需求文档时，要用目标读者的角度去衡量怎样把事情交代清楚，怎样能够让目标读者方便阅读、方便理解。做到心中有读者，就能使得软件项目需求文档的质量不断有提高。