用户研究与选题

写没人要的文档是浪费。技术写作者要像分析师一样 听用户、看数据、跟发布，把文档 backlog 排优先级。

学习目标

• 运用 Persona 与 Buyer Journey 理解文档读者
• 从 Support 工单与搜索日志提取选题
• 建立文档需求 brief 与优先级框架

核心概念

读者 Persona

Persona	目标	文档偏好
后端集成者	调通 API、上线	Reference、Quickstart
课程运营	批量维护内容	How-to、Admin 指南
开源贡献者	提 PR、本地跑	CONTRIBUTING、Architecture
技术决策者	评估是否采用	Overview、Security、SLA

同一功能 often 需要 多 Persona 多入口，而非一篇万能长文。

Buyer Journey 与文档

Awareness — 什么是 CodeRoadMap API（Landing、Concepts）
Consideration — 对比自建 CMS、集成成本（Guide、Case）
Decision — Auth、定价、合规（Trust、Policy）
Onboarding — Quickstart、SDK
Retention — Changelog、Migration、Advanced

文档应覆盖 决策前焦虑（安全吗、稳定吗）与 上手前焦虑（要多久、要什么环境）。

Support 与搜索信号

• 工单聚类：同一错误码出现 20 次 → Troubleshooting
• 站内搜索零结果：直接选题
• 文档页高跳出低时长：结构或前提条件有问题
• Release 前：新字段、Breaking change 必写

选题 Brief 模板

问题 — 用户卡在哪、影响谁
证据 — 工单链接、搜索词、Slack 线程
交付 — 页面类型、Owner、截止日期
成功 — 工单下降 X%、搜索命中、Review 通过

练习

• 为「tracks API 集成者」写半页 Persona
• 从 3 条 mock Support 工单提炼 1 个 Troubleshooting 选题
• 填一份文档 Brief：主题「OAuth 接入」

小结

好选题来自真实 friction；Persona 与 Journey 决定写什么、写多深。 下一课看 CMS、查重与链接追踪等发布工具。