← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 1958.ab

文档按使用任务组织

理解等级:中级

架构文档用于教育、相关者沟通、分析建设和事故取证,既可能约束未来实现,也可能描述已作决定。写到足以让读者找到并完成任务,而不是满足固定页数。设计时记录可帮助当下推理和未来交接;内容必须随系统更新,否则事故时对照组件与接口可能得到错误解释。文档不必是一本纸书,在线协作也能承担这些用途。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 记录架构文档 · 查看原书依据

      Architecture documentation can be seen as both prescriptive and descriptive. For some audiences, it prescribes what should be true, placing constraints on decisions yet to be made. For other audiences, it describes what is true, recounting decisions already made about a system’s design.

    参考来源

    - 位置:《Software Architecture in Practice, 4th Edition》第22章《记录架构文档》(来源项目:book-sources;源文件:extracted/Software Architecture in Practice, 4th Edition/_epub-src/ch22.html) - 结论依据:原文解释架构文档用于教育、相关者沟通、分析建设和事故取证,既可能约束未来实现,也可能描述已作决定;本章后续机制、例子与条件共同限定本卡,原书经验数字和前景不视为当前实测或现状。 - 原始内容:Architecture documentation can be seen as both prescriptive and descriptive. For some audiences, it prescribes what should be true, placing constraints on decisions yet to be made. For other audiences, it describes what is true, recounting decisions already made about a system’s design.