← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 4378.d.1.b.2

历史决定保留原则版本

理解等级:中级

原则变更后,中心页只把当前项放前面,旧项标退役或过时并归入历史。重大变化建新页面并链接旧页,使历史ADR仍能指向当时原则;小修可依赖版本历史。否则后来读者会用今日约定误判当年取舍。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • Collectively Sourced Architectural Principles · 查看原书依据

      Historical ADRs continue to link to the relevant version of a principle. The hub page is up to date, both with regard to active principles and the Legacy section. For the first point, it can be sufficient to update the title of a retired principle to include the flag [RETIRED] if that’s what has happened

    参考来源

    - 位置:《Facilitating Software Architecture》第10章《Collectively Sourced Architectural Principles》(来源项目 /Users/wangyi/claudecodeProject/bookBase/book-sources;源文件:extracted/Facilitating Software Architecture/_epub-src/OEBPS/ch10.html) - 结论依据:原文明列历史链接与hub active/legacy两项维护,区分incremental与significant变更。 - 原始内容:Historical ADRs continue to link to the relevant version of a principle. The hub page is up to date, both with regard to active principles and the Legacy section. For the first point, it can be sufficient to update the title of a retired principle to include the flag [RETIRED] if that’s what has happened