知识卡片

普通读书笔记卡 · 2275.ay.4

不涉及也要写无

理解等级:未标注

架构设计文档中,若方案确实不涉及某个维度,例如可扩展设计,应在对应章节明确写“无”,表示已经考虑过、判断不需要针对性设计,而不是把这一节删掉。完全不写时,评审人很容易认为设计者遗漏了这个点,从而质疑方案的完整性。文档要能替设计者证明“考虑到了、只是判断不用做”,而不是让评审人去猜空白处究竟是想过不需要,还是根本没想到。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《从零开始学架构》第50讲《架构实战:架构设计文档模板》"详细设计"之"可扩展设计"(源文件:`_epub-src/OEBPS/text00004.html`) - 结论依据:原文说明"如果方案不涉及,可以简单写上'无',表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点",直接支撑本卡结论。 - 原始内容:如果方案不涉及,可以简单写上"无",表示设计者有考虑但不需要设计;否则如果完全不写的话,方案评审的时候可能会被认为是遗漏了设计点