知识卡片

普通读书笔记卡 · 2138.x.1

架构评审先准备文档

理解等级:中级

架构评审若反复靠研讨会补齐基本信息,评审者容易变成所有团队等待的瓶颈。先约定文档标准与需要回答的问题,材料不合格就取消会议;团队不会写时提供协助,让他们围绕真实项目形成记录。再缩短会议、聚焦决策及其假设。文档不是增加仪式,而是使问题能在会前被理解、事后被复用。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      如果你的目标不只是评审架构提案,还包括改变组织行为,你就必须接受挑战,改变系统。比如,你可以重新定义架构文档的标准,并取得管理层对诸如提高透明度等的支持。如果团队在会议前无法提供合格的文档,会议就必须取消。如果团队不能完成这种文档,你可以为他们提供架构师,以便帮助他们根据实际项目制作文档。当你缓和一下,并列出一系列具体的问题时,实际的研讨会将变得更加高效。把会议的时间减半还可以让评审过程更有针对性。

    参考来源

    - 位置:《架构师应该知道的37件事》第01章(来源项目:book-sources;源文件:extracted/架构师应该知道的37件事/_epub-src/OEBPS/Text/chapter001.html) - 结论依据:原文要求先定义文档标准,不合格则取消会议,必要时派架构师协助形成材料,并提出将会议减半;这直接给出文档在先、聚焦讨论在后的改进方法。 - 原始内容:如果你的目标不只是评审架构提案,还包括改变组织行为,你就必须接受挑战,改变系统。比如,你可以重新定义架构文档的标准,并取得管理层对诸如提高透明度等的支持。如果团队在会议前无法提供合格的文档,会议就必须取消。如果团队不能完成这种文档,你可以为他们提供架构师,以便帮助他们根据实际项目制作文档。当你缓和一下,并列出一系列具体的问题时,实际的研讨会将变得更加高效。把会议的时间减半还可以让评审过程更有针对性。