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