知识卡片
轻文档保留结构与理由
设计沟通的目标是让团队理解大结构与决策原因,能够展开有意义的争论。可用简图、一两页说明和复杂用例时序图,各服务也保留对应说明;随代码变化更新。API和消息格式需要更精确的详细文档,因为它们承载跨团队约定。自定义图灵活但符号含义可能不统一,必须有文字解释。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 构建与演进系统 · 查看原书依据
We can describe the bigger picture using rough ad hoc diagrams (like I used in Chapter 2), one-to-two-page descriptions, and sequence diagrams for complex use cases. We do the same for each service, and we must update each document when the code changes.
参考来源
- 位置:《Software Architecture and Decision-Making》第13章《Building and Evolving the Systems》(来源项目:book-sources;源文件:extracted/Software Architecture and Decision-Making Leveraging Leadership, Technology, and Product Management to Build Great Products… (Srinath Perera)/_epub-src/ch13.xhtml)
- 结论依据:摘录说明设计沟通的目标是让团队理解大结构与决策原因,能够展开有意义的争论。其余条件结合本章相邻例子与取舍说明,数字示例不作当前性能承诺。
- 原始内容:We can describe the bigger picture using rough ad hoc diagrams (like I used in Chapter 2), one-to-two-page descriptions, and sequence diagrams for complex use cases. We do the same for each service, and we must update each document when the code changes.