歧义语言会破坏您要求的五种方式

Denice Surjan | 2018年3月7日

当需求可以用一种以上的方式解释时,就会出现问题。 专家卡尔·威格斯(Karl Wiegers)在他的论文“撰写高质量的需求”中,举例说明了需求和最佳实践中的含糊不清的问题,以成功地阐明它们。 这里有五个歧义来源和需要克服的技巧。

布尔逻辑为歧义和缺少需求提供了许多机会。 尝试使用决策树来揭示差距并确保清晰度。

当需求缺乏重要信息时,除非读者做出完全相同的假设,否则所有读者不太可能以相同的方式解释它们。 确保包括导致该行为的触发原因,并指出由于该行为或在该行为之后需要进行的操作。 此外,作为要求的一部分,指定操作以及反向操作。 例如:

“系统应以可折叠的层次树结构显示用户定义的书签。”

更改为:

“系统应以可折叠和可扩展的层次树结构显示用户定义的书签。”

数值范围内的边界值是造成歧义的常见原因,它们是寻找缺失需求的好地方。 解决边界混乱的一种简单方法是在表格中显示信息。 如果看到一个在两个范围内表示的数字,则说明某些问题需要解决。 相反,如果表的单元格之一中没有任何值,则可以快速确定缺少的需求。

使用同义词在不同需求下描述同一事物会不必要地引起歧义。 读者会自动知道您的意思是同一件事还是会以为他们不同? 如果它们确实相同,则始终使用相同的词。 如果存在差异,甚至是细微的差异,请将此类定义放在一个共享的词汇表中,以便团队成员理解这些术语并一致地使用它们。

在需求规范中,代词可能会令人头疼。 请确保每当您使用代词时,该前置词就非常清晰。 如果您使用诸如thisthat之类的词,那么读者对您所指的内容应该不会感到困惑。

从专家Karl Wiegers了解更多需求最佳实践。 在他的论文“ 撰写高质量的要求 ”中,他解释说,它们始于适当的语法,结构合理的句子和合乎逻辑的组织。

Denice Surjan | 2018年3月7日


最初于 2018年3月7日 发布在 www.jamasoftware.com 上。