跳到正文

文档维护者

协调写作者、译者和审阅者,维护版本、术语和文档导航。

明确协作分工

写作者负责确定读者任务并验证步骤。译者负责核对上游版本、技术语义和术语。审阅者负责检查可复现性、表达和渲染,给出能定位到具体行或页面的反馈。

维护者协调涉及多页或多个版本的改动,确认贡献者可以从哪里获取原文、预览和术语依据。多人并行更新时,记录各自覆盖的页面和上游提交。

维护长期约定

项目确定新译名、写法或版本策略后,把结论补进对应的术语表或说明页。改动页面路径、标题和导航时,检查已有入口和外部常用地址是否需要重定向。

合并前用审阅清单复查变更。发布后可以从站点导航打开受影响的页面,确认正文、锚点、相邻页和项目链接都指向预期位置。

维持可用的维护记录

把代码发布造成的主要读者影响记在相关议题或 PR 中。需要同时更新多语言时,用译文交接记录说明上游基准和覆盖计划。读者重复遇到同一困惑时,可以按社区答疑流程收集真实问题并回到原页面修订。

维护工作有先后时,优先保证读者能找到正确版本、执行操作并在失败后恢复。用公开可用的事实和预览路径交接,让其他贡献者能复查已完成的工作。