出版与作家生涯2021elasticsearchbook.com
Show HN：我写了一本关于 Elasticsearch 的书
Show HN: I wrote a book about Elasticsearch
导读
这是一位开发者把自己在 Stack Overflow 上回答数百个问题后总结出的入门经验写成了一本 Elasticsearch 手册，重点攻破新手最头疼的查询语言。它不是关于讲故事的书，但它的写作方法对任何写教学类、说明类文字的人都有借鉴：先找到读者真正卡住的地方，再用精选的实例把抽象规则讲清楚。
可以直接用的写作要点
- 01
把回答他人问题时反复遇到的卡点记下来，它就是你的目录大纲——最常见的障碍最该优先写。
- 02
用精选的、可直接上手的实例代替抽象定义，让读者靠'跑通一个例子'建立信心和基础。
- 03
顺着读者的既有经验写：多数人是靠拆解别处能跑通的案例来学新东西的，写作要提供这种可拆解的样本。
- 04
先攻破最陡的那道门槛（这里是查询语言），再谈体系的完整性，别让覆盖面冲淡了重点。
HN 评论精选
从真实提问中提炼读者障碍，用精选实例而非抽象讲解来降低门槛。
作者说：在 Stack Overflow 上回答了几百个问题后，他发现新手入门的主要障碍首先是那套令人生畏的查询语言。大多数人学新技术的方式是反向拆解别处已经跑通的例子，所以他出版了一本手册，用精心挑选的实用示例把查询语言讲透，给读者一个扎实的基础。
gxjoe查看英文原文
Hello all, After hundreds of hours spent on answering questions on stackoverflow, I observed a few barriers of entry that Elasticsearch newbies struggle with. It's first and foremost the formidable query language. Most of us learn a new technology by reverse-engineering what works elsewhere. So I've published a handbook with carefully curated practical examples that demystify the query language and provide a solid foundation to build on. Hope it helps! Cheers
同类还值得读
写书：值得吗？
Writing a book: is it worth it?
Martin Kleppmann（《设计数据密集型应用》作者）复盘写书到底值不值：金钱回报低、耗时极长，但带来了可见度、信任和职业机会。
出版与作家生涯2020 · 642 分 · 287 评4 条写作要点编辑精选写书并不是个好主意
Writing books is not really a good idea
这篇文章讨论靠写书谋生的现实难度，评论区从版税数学、收入预期和写作目标三个角度补充了作者视角。
出版与作家生涯2021 · 577 分 · 609 评4 条写作要点编辑精选如何自助出版一本书：实用资源清单
How to self-publish a book: A handy list of resources
这是一份关于「如何自助出版一本书」的资源清单帖，涵盖从编辑、排版到 ISBN、销售渠道的实操工具与花费。
出版与作家生涯2018 · 558 分 · 88 评4 条写作要点编辑精选我自助出版一本Ruby on Rails书，赚了7万美元
How I Made $70k Self-Publishing a Book about Ruby on Rails
这是一篇 Ruby 开发者自述：他把一套 Rails 性能课程（书＋视频＋答疑）自出版，一年毛收入约 7 万美元，并总结了选题、定价、营销等经验。
出版与作家生涯2017 · 539 分 · 175 评4 条写作要点编辑精选石黑一雄警告年轻作家因“恐惧”而自我审查
Sir Kazuo Ishiguro warns of young authors self-censoring out of 'fear'
石黑一雄提醒年轻作者因“恐惧”而自我审查，即这条帖子讨论的核心。
出版与作家生涯2021 · 396 分 · 641 评5 条写作要点编辑精选