出版与作家生涯2021practical-go-lessons.com
Show HN:我写了一本关于 Go 的书
Show HN: I wrote a book about Go
导读
这是一位作者用两年半业余时间写成的 Go 语言入门书,700 多页、41 章,免费发布在网上。对写作者来说,它提供了一个难得的长篇技术写作样本:如何用章节结构、图示和小结让厚书保持可读,以及怎样把写作风格打磨到对非母语读者也友好。
可以直接用的写作要点
- 01
每章结尾放一个小问答和要点清单,帮助读者把内容真正记下来,而不只是读完。
- 02
大量使用示意图和截图(全书约 405 幅),用图承担一部分解释工作,降低理解门槛。
- 03
追求清晰易读而非炫技:有读者反馈,这本书比同类经典更好读,说明表达简单是一种竞争力。
- 04
先给出可操作的具体步骤,再深入背后的原理和工具,让不同层次的读者都能上手。
HN 评论精选
作者自述:用章节小结和问答结构撑起一本 700 页的厚书,并免费回馈社区。
大家好,经过两年半的写作、无数个周末和夜晚,我发布了一本关于 Go 语言的书。书在网站上免费提供,因为我想回馈开发者社区。全书 700 多页、41 章,约 405 幅插图/截图,力求覆盖 Go 新手应该知道的所有重要主题。每章结尾都有一个小问答和一份要点清单。
maximilienandi查看英文原文
Hello all, After 2.5 years of writing, countless weekends and evenings, I released a book about the Go programming language. The book is available for free on the website because I wanted to give something back to the developer's community :) It is composed of 700+ pages, 41 chapters, and approximately 405 drawings/screenshots. I tried to cover all the important topics that a new Go programmer should know. At the end of each chapter, you can find a small Q/A and a bullet point list of key notions. I would love to hear your feedback about it!
清晰易读的文风本身就是优势,尤其对非母语读者;同时要有意识补齐深度主题。
写得真好!对非母语读者也很容易读。很高兴看到除经典“蓝皮书”之外又多了一个选择。我翻 Go 书或教程时,通常会直接跳到并发那一章看它的深度和质量。如果以后考虑出第二版,建议参考 Katherine Cox-Buday 的《Concurrency in Go》的内容。我很喜欢 Katherine,但你的写作风格读起来轻松得多、也更容易消化,希望她书里有一半内容能迁移到你未来的作品里。
adeptima查看英文原文
Hi maximilienandi, great work! Easy to read for non-native! Always nice to see more alternative to the Blue Book too ;) When I open Golang books or any kind of tutorials, I usually jump into Concurrency sections to see its depth and quality ... If ever start thinking of selling v2 of your book, please go through Katherine Cox-Buday book "Concurrency in Go" content. I like Katherine but your writing style is much much easy to read and process. Wish half of Katherine content will migrate into your future works. Adding reference on Katherine book might help others too.
好的技术章节既给新手可执行的步骤,也向有经验的读者展开深层原理。
我翻了一下目录里看起来最有希望的一章(第 36 章:性能分析),不得不说我很喜欢!一方面有下载特定 zip 文件这类基础步骤,另一方面又深入讲了不同类型的性能分析和必备工具的使用方法。
arendtio查看英文原文
I just scrolled through the chapter that looked most promising to me in the table of contents (Chapter 36: Profiling) and I have to say I love it! On that one hand the basic steps are there like how to download a specific zip file, but at the same time it goes deep into the different types of profiling and how to use the mandatory tools.
同类还值得读
写书:值得吗?
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 条写作要点编辑精选