大家好，我是程序员柏风，AI 最全的 Vibecoding 学习地图 http://coderoadmap.cn 作者。
职业成长
技术写作路径从 Junior → Senior → Lead / DevRel 交叉。证书不如作品集直观；社区贡献与 measurable impact 是进阶筹码。
学习目标
- 了解技术写作者常见职业阶梯与转岗方向
- 建立 Portfolio 与 writing samples 的构成
- 掌握社区参与与持续学习的习惯
核心概念
职业路径
Junior Technical Writer — 单篇 How-to、编辑反馈
Technical Writer — 模块 Owner、API Reference
Senior / Lead — 信息架构、Style Guide、跨团队规划
→ Documentation Manager
→ Developer Advocate / Product Marketing
→ Product Manager（强 domain 背景时）
开源与初创常 一人多角：写 + 发布 + 支持 + 轻度 DevRel。
Portfolio 要素
| 作品 | 展示能力 |
|---|---|
| Quickstart（可跑通） | 用户路径、测试意识 |
| API Reference 节选 | 结构化、完整性 |
| Troubleshooting 案例 | 工单驱动、同理心 |
| Style Guide 片段 | 规范思维、协作 |
| Before/After 改写 | 编辑与信息架构 |
公开 GitHub samples 或 脱敏 PDF；面试时讲 指标（工单降 X%、搜索命中）。
技能进阶
- 浅码能力：读 Java/Spring、跑 Docker、懂 CI
- 工具链：OpenAPI、Docusaurus、Vale、Git
- 数据：文档 analytics、搜索词、A/B 标题（与 PM 协作）
社区与学习
- 参与 Write the Docs、本地 Technical Writing Meetup
- 跟 /roadmaps/technical-writer 补缺口节点
- 读 Google Developer Documentation Style Guide、Microsoft Writing Style Guide
练习
- 列出 Portfolio 还缺的 2 类 samples 及补齐计划
- 用 STAR 法则写一段「改进某 API 文档」的项目经历
- 在 /roadmaps/technical-writer 标记 3 个下季度学习目标
小结
职业靠可验证的文档 impact + 作品集；社区与路线图保持续进阶。 下一课综合练习：为 REST API 写 Quickstart + FAQ。