出版与作家生涯2015pollenpub.com
如何用 Pollen 做出一本书
How to make a book with Pollen
导读
这篇 HN 讨论围绕 Pollen 这个“做书/出版”工具展开，评论集中吐槽主页和教程没有把产品定位讲清楚，并质疑特殊转义符与同类工具的差异。对写作者来说，它提醒我们：说明文档、产品介绍和写作语法都要先降低读者的理解与使用成本。
可以直接用的写作要点
- 01
首页或开头要用一句话说明“这是什么、给谁用、能做什么”，不要让读者靠翻教程猜。
- 02
与同类工具比较时，要明确写出差异和适用场景，否则读者无法判断该选哪个。
- 03
设计写作标记或语法时，要避免使用键盘上难以输入的符号，降低使用门槛。
- 04
教程不能只给零散示例，最好提供一个从输入到成品的完整演示，让读者快速建立整体认知。
HN 评论精选
主页没有清楚说明产品是什么，导致读者无法判断用途。
我完全不知道 Pollen 是做什么的。主页真的什么都没解释，就算快速浏览教程和 quick tour，我还是不知道。它是静态网站生成器？博客引擎？能生成 PDF？Epub？我毫无头绪。
aaronbasssett查看英文原文
I have no idea what Pollen does. The homepage really doesn't explain anything, and even after skimming the tutorials and the quick tour I still don't know. Is it a static site generator? A blogging engine? Does it create PDFs? Epub? I have no idea.
转义符选用不常见字符会显著增加输入负担。
不过我不太能接受用 ◊ 作为转义字符。它不在任何常用键盘上，所以除非本意就是让用户尽量别用它，否则这实在太难忍受了。
dsr_查看英文原文
I don't think I can forgive the use of ◊ as an escape character, though. It is not on any commonly used keyboard, so unless the intent was to make users avoid it as much as possible, it's just too awful to put up with.
缺少与同类工具的明确对比，读者难以理解差异。
有没有书面讨论说明 Pollen 相比 Racket Scribble 有什么优势？听起来非常相似。
omaranto查看英文原文
Is there any written discussion of advantages that Pollen has over racket Scribble? It sounds extremely similar.
同类还值得读
写书：值得吗？
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 条写作要点编辑精选