技术写作与文档2016news.ycombinator.com编辑精选
Ask HN：靠技术写作能养活自己吗？
Ask HN: Is it possible to live off technical writing?
导读
一位合著过 Python 书的作者在 HN 上提问：能否靠写技术内容为生、如何起步。多位有实战经验的技术写作者和独立作者回复，勾勒出两条路径——进公司做全职技术写作，或自己出书做个人品牌——并给出关于收入、时间投入和营销的真实预期，适合想靠写作变现的技术人阅读。
可以直接用的写作要点
- 01
有技术背景再补写作能力，比纯写作背景补技术更容易入行；合著过书本身就是可用的敲门砖。
- 02
把出书当生意经营：大约 80% 精力放在营销、20% 放在把书推向发行渠道，否则收入会很薄。
- 03
自出版（如 Amazon/CreateSpace）能拿到约 45% 的标价，而给传统出版社写书通常不到 5%，差距值得认真权衡。
- 04
一本高质量的书大约要写一年，先用文章和小书积累作品集和读者名单，再考虑全职写作。
同类还值得读
编写更好文档的框架
A Framework for Writing Better Documentation
这是 Divio 的文档写作框架，把技术文档按「读者的目标」分成四类：教程（学习导向）、操作指南（问题导向）、参考（信息导向）、解释（理解导向）。
技术写作与文档2021 · 637 分 · 76 评4 条写作要点编辑精选写好一份设计文档
Writing a good design document
这篇 HN 帖子标题为《Writing a good design document》，主题是如何写好一份设计文档；对写作者来说，它值得作为技术写作和结构化说明文的参照。
技术写作与文档2025 · 581 分 · 147 评3 条写作要点编辑精选技术写作课程
Technical Writing Courses
这是 Google 官方免费技术写作课程（两门），讲受众定义、主动语态、短句、文档结构等基础方法。
技术写作与文档2020 · 571 分 · 73 评4 条写作要点编辑精选写出更好的错误信息
Write better error messages
这篇帖子讨论如何写出更好的错误信息，评论补充了开发者场景下的具体做法和真实反面案例。
技术写作与文档2022 · 566 分 · 253 评4 条写作要点编辑精选写一本技术书的经济账
The Economics of Writing a Technical Book
一位技术书作者拆解写书的真实经济账：版税收入往往远低于投入的时间成本。
技术写作与文档2018 · 519 分 · 149 评4 条写作要点编辑精选