11.7

我曾经极度厌恶写文档，觉得它是开发的累赘。直到我试图去理解一段没有注释、没有文档的祖传代码，那种如同在黑暗中摸索的痛苦让我彻底醒悟。文档，不是写给现在的自己，而是写给未来的自己、你的队友和后续的维护者。它是项目的“使用说明书”和“历史档案”。好的代码是自解释的，但好的文档能解释“为什么”要这么写，这远比“是什么”更为重要。