知识卡片
架构评审先准备文档
架构评审若反复靠研讨会补齐基本信息,评审者容易变成所有团队等待的瓶颈。先约定文档标准与需要回答的问题,材料不合格就取消会议;团队不会写时提供协助,让他们围绕真实项目形成记录。再缩短会议、聚焦决策及其假设。文档不是增加仪式,而是使问题能在会前被理解、事后被复用。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
- · 1.6 刨根问底
原书出处 · 1 处
- · 查看原书依据
如果你的目标不只是评审架构提案,还包括改变组织行为,你就必须接受挑战,改变系统。比如,你可以重新定义架构文档的标准,并取得管理层对诸如提高透明度等的支持。如果团队在会议前无法提供合格的文档,会议就必须取消。如果团队不能完成这种文档,你可以为他们提供架构师,以便帮助他们根据实际项目制作文档。当你缓和一下,并列出一系列具体的问题时,实际的研讨会将变得更加高效。把会议的时间减半还可以让评审过程更有针对性。
参考来源
- 位置:《架构师应该知道的37件事》第01章(来源项目:book-sources;源文件:extracted/架构师应该知道的37件事/_epub-src/OEBPS/Text/chapter001.html)
- 结论依据:原文要求先定义文档标准,不合格则取消会议,必要时派架构师协助形成材料,并提出将会议减半;这直接给出文档在先、聚焦讨论在后的改进方法。
- 原始内容:如果你的目标不只是评审架构提案,还包括改变组织行为,你就必须接受挑战,改变系统。比如,你可以重新定义架构文档的标准,并取得管理层对诸如提高透明度等的支持。如果团队在会议前无法提供合格的文档,会议就必须取消。如果团队不能完成这种文档,你可以为他们提供架构师,以便帮助他们根据实际项目制作文档。当你缓和一下,并列出一系列具体的问题时,实际的研讨会将变得更加高效。把会议的时间减半还可以让评审过程更有针对性。