【文档篇】文档体系与预算控制：如何治理膨

DeepSeek 治理膨胀的技术文档，核心就一招：把文档当代码管。

很多老项目的文档容易得“中年危机”：新手教程里塞满底层细节，同一原理到处复制导致说法打架，单篇更是无限膨胀没人敢看。为了治这病，他们定了三条死规矩：

教程和手册必须分家：新手教程只负责一步步带你跑通 Demo，严禁长篇大论讲底层原理；底层字典和参数说明全扔进参考手册，方便老手直接查。
一个事实只能写在一个地方：某个架构或配置项，全仓库只能有一份权威解释。其他地方想提，必须用链接指过去，绝对不许复制粘贴。
给文档设硬性字数上限：核心文档都有字数红线，超标了 CI（持续集成）直接报错拦截。超了怎么办？先拆分子文档，再精简废话，实在不行才允许申请加字数。

另外，只要改了文件名或标题，CI 会强制要求在同一次提交里修好所有相关链接，绝不许带坏链入库。

说白了，好文档不是靠人自觉，而是靠流程卡住。