第3章 文档角色与职责
作者 · 审校者 · 审批者 · 发布者 · 维护者
一份高质量的技术文档，离不开清晰的角色划分与协作流程。每个角色各司其职，才能保证文档的准确性、一致性和时效性。本章详细定义五大核心角色及其职责边界。
3.1 角色总览
文档从创建到废弃，通常经历 起草 → 审校 → 审批 → 发布 → 维护 五个阶段。每个阶段由不同角色主导，形成闭环。
| 角色 | 核心职责 | 关键输出/活动 |
|---|---|---|
| 作者 | 文档内容撰写、结构设计、素材整理 | 初稿、修订稿、变更请求 |
| 审校者 | 技术准确性、语言表达、格式规范检查 | 审校意见、批注、修改建议 |
| 审批者 | 最终内容核准、发布授权 | 审批签字、发布许可 |
| 发布者 | 文档排版、版本标记、归档与分发 | 发布版本、归档记录、访问权限 |
| 维护者 | 文档更新、废弃管理、版本回溯 | 更新日志、版本迁移、废止通知 |
3.2 职责详细说明
✍️ 作者 (Author)
- 根据模板和规范创建文档初稿，确保内容完整、逻辑清晰。
- 与主题专家 (SME) 协作，收集技术细节与数据。
- 主动发起修订，并记录变更说明。
🔍 审校者 (Reviewer)
- 检查技术准确性：术语、代码、数据、流程是否正确。
- 检查语言与格式：语法、拼写、标点、排版是否符合规范。
- 提出可操作的修改建议，并标注优先级。
✔️ 审批者 (Approver)
- 对文档内容做最终确认，通常由项目经理或技术负责人担任。
- 评估文档是否满足发布标准，并承担发布责任。
- 在审批系统中签署或电子签名。
📦 发布者 (Publisher)
- 执行文档的最终排版、水印、密级标记。
- 分配文档编号、版本号，并上传至知识库或文档管理系统。
- 通知相关方文档已发布，并回收旧版本。
🔄 维护者 (Maintainer)
- 定期审查文档有效性，根据产品迭代更新内容。
- 管理文档版本历史，确保可追溯。
- 发起文档废弃流程，并归档旧版。
3.3 职责矩阵 (RACI)
以下矩阵明确各角色在文档关键活动中的参与程度：R=执行者, A=负责人, C=被咨询者, I=被通知者。
| 活动 | 作者 | 审校者 | 审批者 | 发布者 | 维护者 |
|---|---|---|---|---|---|
| 内容起草 | R/A | C | I | — | — |
| 技术审校 | C | R/A | I | — | — |
| 最终审批 | C | C | R/A | I | I |
| 发布与归档 | I | I | C | R/A | C |
| 持续维护 | C | C | I | C | R/A |
💡 最佳实践： 每个文档在创建时即指定明确的作者、审校者、审批者、发布者和维护者。建议在文档封面或修订记录中列出角色姓名，以增强责任感。
3.4 角色切换与协作流程
文档流转通常遵循 作者 → 审校者 → 审批者 → 发布者 → 维护者 的顺序。但在敏捷环境中，角色可以重叠（例如作者也可担任维护者），但审批者必须独立，以保证质量门禁。
3.5 常见问题与建议
- 角色缺失： 至少保证作者、审校者、审批者三个角色到位，否则文档质量不可控。
- 角色冲突： 避免同一人同时担任作者和审批者，审校者与作者应尽量分离。
- 职责模糊： 使用 RACI 矩阵在项目启动时明确分工，并写入文档计划。