Original Note

rust-analyzer 架构文档示例:从结构到不变量 - Outline

Outline

  1. rust-analyzer 架构文档示例:从结构到不变量(整理版)
  2. 内容简要概括
  3. 目录
  4. 1. 顶层模型:输入、派生状态与增量更新
  5. 2. Code Map 的层次与边界
  6. 3. 最值得迁移的架构不变量
  7. 3.1 让输入与实现细节解耦
  8. 3.2 把 API Boundary 画在稳定的抽象层
  9. 3.3 用失效范围约束增量系统
  10. 3.4 将不完整与失败视为一等场景
  11. 4. 横切关注点如何进入架构文档
  12. 4.1 代码生成
  13. 4.2 取消与快照
  14. 4.3 测试
  15. 4.4 错误处理与 observability
  16. 5. 对编写自身 ARCHITECTURE.md 的启示