《软件需求最佳实践》阅读笔记06

第7章 需求描述最佳实践

需求描述的风格与格式

在描述需求时，我们首先确定以什么风格来表述，另外还应该选择与项目、团队特点相符合的风格模板。

常见的描述风格与选用标准

在描述需求时，最常见的描述风格个可以分成自然语言、图形化模型和形式化规格描述3种

1. 自然语言，也就是使用结构合理的自然语言来描述需求，这种形式不管对于写的人还是看的人，都是一个很容易接受的方法，一直以来这都是描述需求的首选方法。
2. 图形化模型，图形化模型在表述时能够给读者提供更强的视觉效果，同时能够使问题更加聚焦。所以我们在日常的交流中，经常会在纸上绘制一些非标的、低保真的示意图，以更好地完成沟通。
3. 形式化规格描述，如果说图形化建模的精确度比自然语言高的话，那么形式化规格描述则比图形化模型跟高。对于逻辑性很强、精度要求很高的场合，形式化规格描述就是一种不错的选择，其主要优点是严谨、精确；缺点是编写和阅读的人都会感到和困难，容易产生理解歧义。
4. 选择建议

a)        自然语言为主，复制以图形化模型，需要的地方少量使用形式化规格描述。

b)        图形化模型为主，辅之以自然语言作为补充，需要的地方少量使用形式化规格描述

c)        以形式化规格语言为主，辅之以图形化模型，以自然语言为补充：适用于质量要求很高的领域。

写作策略技巧

1. 文字表达的先天不足

a)        非文字信息的缺乏导致信息的丢失

b)        说着无心，听者有意

1. 不要忽视陈述需求理由的重要性
2. 注意措辞

a)        尽可能减少使用定性词语，定性词语也就意味着不确定

                        i.              有效：什么称为有效地支持，具体表现在什么地方？

                      ii.              依赖：什么样的依赖，流程依赖，还是其他什么依赖关系？

b)        避免使用描述数据的词语，另一类容易产生歧义的时对数据规则进行描述的词语，这些都是容易产生疏忽，因此我们应该改为使用数据表达式来说明。

小结

做好需求描述的核心秘诀在于谨记“信息的有效传递”。在本章中，分析了集中典型的需求规格说明模板，阐释了“沟通决定内容，内容决定格式”的道理本章强调了需求写作是“结构化文本”为主的应用文，要避免使用定性的、表示数据的词语，要尽量支出需求的理由，这样就是更加有效地完成需求的文档化和信息的传递。