HN 写作课

工程师们二十年里聊过的写作。

工程师、作家、编辑和创业者在 Hacker News 上聊了二十年“怎么写”:怎么写得清楚、怎么讲好一个故事、技术文档怎么写、小说和出版是怎么回事。这里把其中关于写作与讲故事的帖子挑出来,配上中文导读、可以直接用的写作要点和评论翻译。

从必读开始
  • 2,600+篇关于写作的 HN 讨论

Writing tips

写作锦囊

正在抽一条写作要点…

Essential

必读 30 篇

在讨论库里看全部精选

编辑精选里 HN 讨论最热的 30 篇,每篇都有中文导读和写作要点。

  1. 正在载入…

Archive

讨论库

按发帖年份分布,点柱子筛选。

排序

    About

    这些讨论是怎么挑出来的

    1. 01

      从全量里捞

      读取 Hacker News 自 2006 年以来的全部帖子,用关键词先捞出 40 分以上、可能和写作有关的约 1.1 万篇。

    2. 02

      只留真正讲写作的

      由 AI 逐条判断是否和写作、讲故事、文风、出版有实质关系,剔除“写代码”“编辑器”这类字面撞车,并分进十个类别。

    3. 03

      提炼可用的要点

      为值得读的帖子写中文导读,提炼 2-4 条可以直接用到自己写作里的要点,并精选翻译 HN 高赞评论。内容由 AI 生成,可能有误。

    语言与文风2012prog21.dadgum.com编辑精选

    一个关于啰嗦的短篇故事

    A Short Story About Verbosity

    阅读原文 HN 讨论
    82HN 得分
    21条评论
    4条写作要点

    导读

    这篇短文讲的是出版界对“篇幅”的执念:一本技术书被要求写到 600 页,仿佛厚度本身就是价值。评论区的出版从业者和读者拆解了这种“越长越好”逻辑背后的销售动机,也给出了判断合适篇幅的实用标准——对任何要决定“写多长”的写作者都有参考价值。

    关键词 篇幅控制简洁写作技术书籍读者体验

    可以直接用的写作要点

    1. 01

      篇幅应由“必须说清的内容”决定,而不是由页数指标、书脊厚度或“显得全面”的市场心理决定。

    2. 02

      厚度常被当成完备性的替代指标,但真正被读者读完、用上的往往只是其中一小部分——写之前先想清楚读者实际需要什么。

    3. 03

      给作品设定一个具体的使用场景(如“一次洲际航班读完”),是控制篇幅、保持可读性的有效约束。

    4. 04

      多人合写的大部头容易重复、自相矛盾、留漏洞;需要协作时要有人统一体例和取舍。

    HN 评论精选

    好书的长度等于把话说清楚所需的长度,页数本身没有价值。

    不知道出版商是谁,但听起来不像 O'Reilly。我在 2000 年代为 O'Reilly 工作时,我们的信条是一本书的合适长度就是“把该说的说完所需要的长度”。大约 120–150 页是下限,低于这个厚度书脊上放不下可见的封面,但 600 页相对 250 页并没有内在好处。当然做电子书就没有最小篇幅这回事了:市场需要多长就多长。

    gnat查看英文原文

    I don't know who the publisher was, but it doesn't sound like O'Reilly. When I worked for them (in the 2000s) our mantra was that the right size for a book is however long it has to be to say what has to be said. There's a minimum length of around 120-150 pages, below which it's hard to have a visible cover on the spine, but there's no inherent benefit to 600 page books versus 250. With ebooks, of course, there's no such thing as a minimum size: it's whatever there's a market for.

    多人拼凑的大部头往往重复、矛盾、有漏洞。

    按我的经验,最该避开的技术书就是那种又厚、作者又超过四位的。作者之间通常缺乏协调,结果是前后不一致、内容有缺口、大量重复。

    Angostura查看英文原文

    In my experience, the technical books to avoid are the really fat ones with more than four authors. There is usually little coordination between authors, meaning inconsistencies, holes, repetition abounds.

    厚度是书架营销和 B2B 销售的手段,牺牲的是内容质量。

    我对“600 页规则”的猜测是:这个长度能让书有漂亮的厚书脊,而厚书脊正好适合用超大字号印上抓人的书名,这在实体书架上促销时大概很有用。此外,篇幅还能被当作“内容完备”的代理指标,这在面向企业、学界等 B2B 渠道卖书时很有帮助——这类买家往往更爱抱怨书里“没写到什么”,而不是“写了什么”,于是就有了这种“什么都塞进去”的倾向。这一切当年对销量是好事,对书的质量却不是。

    jonnathanson查看英文原文

    My best guess about the "600 pages" rule is that such a length gives the book a nice, thick spine, and a nice, thick spine is a great place to plant a catchy title in enormous lettering. That probably helped when selling the book on shelves. Furthermore, length could be used as a proxy for comprehensiveness, which helped when selling the book through B2B channels, like corporations, academia, etc. (Oftentimes, such buyers were more likely to complain about what a book didn't contain than what it did, hence, the drive toward kitchen-sinkism). All of which was great for sales back in the day, but not so great for the quality of the books.

    入门书宜短,用具体阅读场景来定篇幅。

    《点石成金》(Don't Make Me Think)一书里说,它期望的阅读场景是一次洲际航班上轻松读完。我觉得这对入门书来说是很好的长度。我读过一些编程语言的入门书,通常我真正需要的只是一个好的语法介绍,加上点明这门语言的优势和特殊之处;剩下的反正编程时自己会摸索出来。可惜这意味着我通常只读半本书。

    Derbasti查看英文原文

    The book Don't Make Me Think states that it is meant to be easily readable during one intercontinental flight. I think that is a good length for an introductory book. I have read a introductory books about programming languages. Usually, all I really need is a good introduction into the syntax and a pointers to the strenghts and peculiarities of a language. All the rest I will have to figure out while programming anyways. Sadly though, this means that I will typically only read about half the book.

    同类还值得读

    1. 像说话一样写作

      Write like you talk

      这篇短文主张写作应像说话一样自然、清晰,避免装腔作势的书面腔。

      语言与文风2015 · 647 分 · 272 评4 条写作要点编辑精选
    2. 法律语言难懂源于写作不佳,而非专业概念

      Poor writing, not specialized concepts, drives difficulty with legal language

      这是一项认知科学研究:法律文本难懂,主要不是因为充斥专业术语,而是因为写作者把句子写得又长又绕、修饰语层层嵌套、回指距离过远。

      语言与文风2022 · 559 分 · 322 评5 条写作要点编辑精选
    3. 写得简单

      Write Simply

      保罗·格拉汉姆在这篇短文里主张:好文章应该写得简单——用日常词汇、短句、直白的结构,不为显得聪明而堆砌复杂表达。

      语言与文风2021 · 484 分 · 330 评4 条写作要点编辑精选
    4. Tortured phrases:科学写作中出现的一种可疑文风

      Tortured phrases: A dubious writing style emerging in science

      《自然》新闻报道了一种在科学论文中蔓延的怪现象:原本标准的术语被同义替换软件改写成了古怪说法,比如把 "cloud computing" 写成 "haze figuring"。

      语言与文风2021 · 329 分 · 256 评4 条写作要点编辑精选
    5. 乔治·奥威尔 1940 年对《我的奋斗》的书评

      George Orwell's review of Mein Kampf (1940)

      这是奥威尔1940年对《我的奋斗》的书评。

      语言与文风2014 · 305 分 · 240 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

    微信公众号「向阳乔木推荐看」

    微信公众号「向阳乔木推荐看」二维码

    微信扫一扫;在微信里打开本页时,长按二维码识别。