本页介绍一系列方法，从自动化检查到内容生命周期管理，帮助你长期确保文档的准确性与价值。
尽可能实现自动化
- 跟踪过时内容： 运行脚本标记过去三个月未更新的重要文档。它们是否仍然准确？
- 自动更新文档： 构建工作流，当代码合并时，通过 agent API 自动更新文档。
- 用 linter 强制执行标准： 使用 Vale 或 CI 检查，在每个拉取请求（PR；亦称“合并请求”/Merge Request）中自动捕获格式问题、写作风格偏差或缺失的 metadata。
建立评审流程
- 聚焦高影响力文档。 并非每个页面都需要定期更新。务必定期审查最重要的页面，确保其准确且具备时效性。
- 善用社区力量。 如果你的文档是开源的，赋予用户通过拉取请求（PR；亦称“合并请求”/Merge Request）标记问题或提交修复的能力。这有助于建立信任并保持内容新鲜。
何时该重写
- 规划定期归零。 一次大规模清理，尤其是在最佳实践或产品本身已有显著演进时，能为团队和用户节省时间。
- 从结构化盘点开始。 在重写前，访谈支持团队、分析用户反馈，并记录缺失、误导或冗余的内容。
- 以聚焦冲刺完成重写。 全面重构不必一蹴而就，优先处理影响最大的部分。