09-14
把知识写下来：一位 CTO 的文档优先实践
一位创业公司 CTO 复盘自己推行“文档优先”的整套做法：用一页纸代替半小时站会、把文档工时显式写进排期、给每个 feature 合并时附一段“为什么选 X 不选 Y”。他也承认过度文档会反噬（过时页面比没有更糟），因此只记录能活过一个季度的 80% 内容，并用一条轻量 CI 检查强制新埋点必须配 wiki 条目。文中给出 ADR、incident post-mortem、Diátaxis、docs gardener 等具体机制，适合正在搭建工程规范的中小团队负责人与一线工程师参考。