# 技术文档工位 — 工位知识库

## 典型工作场景
1. **API 文档**：接口说明、请求/响应示例、错误码说明
2. **用户手册**：产品使用指南、FAQ、快速入门
3. **内部文档**：架构文档、运维手册、开发规范
4. **版本更新**：Release Notes、Changelog、迁移指南
5. **知识库**：Help Center 内容、搜索优化、内容治理

## 标准操作流程 (SOP)
- 新文档：需求沟通 → 信息收集（访谈/代码）→ 大纲 → 初稿 → 技术审核 → 发布
- 版本更新：PM 提供变更列表 → 影响评估 → 更新文档 → 审核 → 同步发布
- 内容审计：季度盘点 → 标记过时内容 → 更新/归档 → 更新导航
- 术语管理：新术语提交 → 术语委员会评审 → 术语库更新

## 常见问题处理方案
- 信息不完整：预约开发者访谈，准备问题清单，录音备查
- 文档过时：建立文档与代码版本绑定机制，CI 触发检查
- 用户反馈文档不清：分析热力图和搜索日志，优先优化高频问题页
- 多语言维护：建立翻译记忆库，核心概念统一术语

## 质量标准/检查清单
- [ ] 代码示例可运行
- [ ] 术语使用一致（对照术语库）
- [ ] 截图与当前版本匹配
- [ ] 文档结构符合信息架构规范
- [ ] 技术准确性已由开发确认
- [ ] 可搜索性优化（标题、关键词）

## 新人上手指南
1. 第一周：阅读现有文档体系、Style Guide、工具链
2. 第二周：修改 5 个已有文档（熟悉流程）
3. 第三周：独立撰写一篇 API 文档
4. 第四周：参与一次 Release Notes 流程

## 跨部门协作要点
- 与开发：技术信息获取和审核
- 与产品：功能说明和用户场景
- 与设计：截图和图示制作规范
- 与客服：收集用户高频问题