技术写作与文档2015scottmeyers.blogspot.com
《Effective Modern C++》的出版过程（下）
Publishing Effective Modern C++, Part 2
导读
Scott Meyers 在《Effective Modern C++》出版过程的第二部分里，把技术出版拆成四件事：写稿、制作、发行、营销，并回顾自己与出版社打交道的实际经验。对写作者来说，值得读的地方在于：它把“出一本书”从浪漫想象变成可以逐项核算的商业流程，帮助你判断哪些环节该外包、哪些必须自己把控。
可以直接用的写作要点
- 01
把出版拆成写作、制作、发行、营销四个环节，逐项问自己：这一环我自己能做吗？外包能换来什么？
- 02
脚本和工具可以替代排版、转换等制作环节，但结构编辑（developmental editing）和文字编辑替代不了，这部分预算最值得花。
- 03
自出版通常能拿到标价 30%–40% 的版税，传统出版社可能只有 4%–8%，所以决策的关键是：出版社的发行与营销能否让销量翻十倍。
- 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 条写作要点编辑精选