知识卡片
不涉及也要写无
架构设计文档中,若方案确实不涉及某个维度,例如可扩展设计,应在对应章节明确写“无”,表示已经考虑过、判断不需要针对性设计,而不是把这一节删掉。完全不写时,评审人很容易认为设计者遗漏了这个点,从而质疑方案的完整性。文档要能替设计者证明“考虑到了、只是判断不用做”,而不是让评审人去猜空白处究竟是想过不需要,还是根本没想到。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 架构实战:架构设计文档模板 · 查看原书依据
如果方案不涉及,可以简单写上“无”,表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点
参考来源
- 位置:《从零开始学架构》第50讲《架构实战:架构设计文档模板》"详细设计"之"可扩展设计"(源文件:`_epub-src/OEBPS/text00004.html`)
- 结论依据:原文说明"如果方案不涉及,可以简单写上'无',表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点",直接支撑本卡结论。
- 原始内容:如果方案不涉及,可以简单写上"无",表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点