知识卡片
细节一致性级别的三种歧义
内容
模型细节更多不一定更好，应追求”细节一致性级别”而非某些部分比其他部分更详细。细节级别不一致会让读者困惑，因为无法分辨原因：是模型未完成？是作者不知道这些细节而遗漏？还是作者认为不重要而故意省略？若不可避免地不一致，应加注释说明理由。想展示局部额外细节，应先建一致级别的模型，再对选中部分做细化模型。
参考来源
- 位置：《恰如其分的软件架构》第15章《使用架构模型》15.1.5节《细节的一致性级别》（源文件：_epub-src/OEBPS/text00160.html）
- 结论依据：原文说明细节级别不一致会让读者无法区分"未完成/遗漏/故意省略"三种原因，建议加注释解释，并给出"先建一致级别模型再细化选中部分"的做法。
- 原始内容：有着多个细节级别的模型可能会使读者感到困惑，因为细节级别不同可能由不同原因引起。一种解释是模型还没有完成。另一种解释是，因为不知道某些细节，所以模型中遗漏了它们。最后一种解释是，因为某些细节不重要，所以模型故意忽略它们。如果你必须创建一个细节级别上不一致的模型，就应该在模型上放一个注释，解释这样做的理由。