知识卡片

普通读书笔记卡 · 3213.b

记录架构决策的取舍

理解等级:高级

代码展示系统做了什么,却难还原当时为何选择某种设计。架构文档应随实现更新,记录问题、备选方案及权衡。

否则团队更替后,隐含在个人脑中的架构难以复用,也容易在重构时重踩旧坑。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《高可用可伸缩微服务架构》第1章《微服务架构概述》1.4节“架构以文档和代码呈现”(源文件:OEBPS/Text/chapter006.xhtml) - 结论依据:原文指出代码仅呈现当前切面,设计过程和取舍会丢失;文档需同步维护以降低跨团队及人员变动的沟通成本。 - 原始内容:如果我们没有留下来任何思考的痕迹,那么这些思想过程的智慧就会在软件的创造过程中丢失。随着时间的流逝,我们只能看到系统最终的样子。这种信息缺失对于目前大规模软件开发的协作过程非常不利。