知识卡片
动态架构先记录不变量
系统运行时扩展或高频部署会快过人工文档周期,应记录所有合法版本共同遵循的接口、插入点与约束,另说明允许的添加替换方式。能从显式接口自动生成的文档应接入版本历史和检索,减少漂移。动态不等于无架构,文档可从固定实例清单转为约束与变化规则;书中浏览器插件例仅说明此原则,不代表当前浏览器行为。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 记录架构文档 · 查看原书依据
Document what is true about all versions of your system. Your web browser doesn’t go out and grab just any piece of software when it needs a new plug-in; a plug-in must have specific properties and a specific interface.
参考来源
- 位置:《Software Architecture in Practice, 4th Edition》第22章《记录架构文档》(来源项目:book-sources;源文件:extracted/Software Architecture in Practice, 4th Edition/_epub-src/ch22.html)
- 结论依据:原文解释系统运行时扩展或高频部署会快过人工文档周期,应记录所有合法版本共同遵循的接口、插入点与约束,另说明允许的添加替换方式;本章后续机制、例子与条件共同限定本卡,原书经验数字和前景不视为当前实测或现状。
- 原始内容:Document what is true about all versions of your system. Your web browser doesn’t go out and grab just any piece of software when it needs a new plug-in; a plug-in must have specific properties and a specific interface.