知识卡片
历史决定保留原则版本
原则变更后,中心页只把当前项放前面,旧项标退役或过时并归入历史。重大变化建新页面并链接旧页,使历史ADR仍能指向当时原则;小修可依赖版本历史。否则后来读者会用今日约定误判当年取舍。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 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