第7章 需求描述最佳实践
需求描述的风格与格式
在描述需求时，我们首先确定以什么风格来表述，另外还应该选择与项目、团队特点相符合的风格模板。
常见的描述风格与选用标准
在描述需求时，最常见的描述风格个可以分成自然语言、图形化模型和形式化规格描述3种
- 自然语言，也就是使用结构合理的自然语言来描述需求，这种形式不管对于写的人还是看的人，都是一个很容易接受的方法，一直以来这都是描述需求的首选方法。
- 图形化模型，图形化模型在表述时能够给读者提供更强的视觉效果，同时能够使问题更加聚焦。所以我们在日常的交流中，经常会在纸上绘制一些非标的、低保真的示意图，以更好地完成沟通。
- 形式化规格描述，如果说图形化建模的精确度比自然语言高的话，那么形式化规格描述则比图形化模型跟高。对于逻辑性很强、精度要求很高的场合，形式化规格描述就是一种不错的选择，其主要优点是严谨、精确；缺点是编写和阅读的人都会感到和困难，容易产生理解歧义。
- 选择建议
a) 自然语言为主，复制以图形化模型，需要的地方少量使用形式化规格描述。
b) 图形化模型为主，辅之以自然语言作为补充，需要的地方少量使用形式化规格描述
c) 以形式化规格语言为主，辅之以图形化模型，以自然语言为补充：适用于质量要求很高的领域。
写作策略技巧
- 文字表达的先天不足
a) 非文字信息的缺乏导致信息的丢失
b) 说着无心，听者有意
- 不要忽视陈述需求理由的重要性
- 注意措辞
a) 尽可能减少使用定性词语，定性词语也就意味着不确定
i. 有效：什么称为有效地支持，具体表现在什么地方？
ii. 依赖：什么样的依赖，流程依赖，还是其他什么依赖关系？
b) 避免使用描述数据的词语，另一类容易产生歧义的时对数据规则进行描述的词语，这些都是容易产生疏忽，因此我们应该改为使用数据表达式来说明。
小结
做好需求描述的核心秘诀在于谨记“信息的有效传递”。在本章中，分析了集中典型的需求规格说明模板，阐释了“沟通决定内容，内容决定格式”的道理本章强调了需求写作是“结构化文本”为主的应用文，要避免使用定性的、表示数据的词语，要尽量支出需求的理由，这样就是更加有效地完成需求的文档化和信息的传递。