7.2.1 官方文档与 Wiki

文档摘要

7.2.1 官方文档与 Wiki 在开源世界里，文档不是说明书，而是源码的第二层抽象；Wiki不是知识仓库，而是社区共识的实时快照。当你深夜调试一个却在Stack Overflow上翻到三篇互相矛盾的答案时，真正能救你的，从来不是某位匿名用户的猜测，而是官方文档里那行被你跳过的、加了标记的默认值注释——它藏在第187行，被调用链中第4层条件分支所覆盖，而这个分支只在且未显式传入时才激活。这就是为什么我们把“7.2.1 官方文档与 Wiki”单列一节，不是因为它“重要”，而是因为它可执行、可验证、可调试、可版本化、可测试——它是一套运行时系统，而非静态文本。一、文档即代码：从 Markdown 到可执行规范现代官方文档早已脱离“写完就发布”的线性流程。