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 生成,可能有误。

    出版与作家生涯2021prospectmagazine.co.uk

    书索引的激进力量

    The radical power of the book index

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

    导读

    这篇文章以书籍索引为切口,探讨人工编排的知识导航如何对抗廉价的自动化替代——好的索引不仅是检索工具,更是作者与读者之间的智力对话。文中那个「糟糕的索引→参见自动索引→试图像人一样索引/失败」的嵌套玩笑,生动展示了索引本身可以成为犀利的评论。对写作者而言,这提醒我们:结构设计、交叉引用和对读者注意力的尊重,本身就是写作的一部分。

    关键词 书籍索引人工索引信息组织读者体验

    可以直接用的写作要点

    1. 01

      索引的交叉引用和子标题本身可以承载态度与幽默(如「糟糕的索引→参见自动索引」),说明副文本也能参与表达。

    2. 02

      人工索引的价值在于编辑判断——知道什么该放在一起、什么值得参见,这种判断力是算法难以复制的。

    3. 03

      书后索引正在消亡、人工索引技艺面临失传,提醒我们好的导航结构需要专门投入,不能默认「够用就行」。

    4. 04

      为读者提供清晰的导航(目录、索引、章节标记),本质上是对读者时间的尊重,这在任何媒介中都适用。

    HN 评论精选

    索引的交叉引用和子标题可以成为讽刺与评论的载体,展示副文本的表达潜力。

    如果我们还没领会到意思,她在「糟糕的索引」词条下写着「参见自动索引」。翻到「自动索引」,两个子标题分别是「试图像人一样索引 254」和「失败 304–7」。人们明知结果更差却还在用,理由是「成本」——电脑能省钱,结果也勉强够用。这种「机器接管但做得更差」的现象在音乐排版、圣经印刷、书籍装订(热熔胶取代冷胶)等领域都能看到。

    chrismorgan查看英文原文

    > And if we hadn’t quite got the message, her entry for “bad indexes” tells us to “see also automated indexing.” Go to “automated indexing,” and the two subheadings read “attempts to index like a human 254” and “fails 304–7.” And yet people keep doing it even though it produces an inferior result. “Cost,” you might say, “is reduced by using a computer, and the result good enough that we can get away with it.” And this is true of many fields where computers have taken over but do a worse job, such as music engraving (compare the old masters to the default or even moderately tuned output of just about anything other than Lilypond and there’s a huge difference if you’re a player; Lilypond, being deliberately designed to do better, does better, though it still needs some skill to produce truly excellent results) and typesetting of Bibles (readily observable in print if you’re looking for it and compare Bibles over time; and glaringly obvious in Bible software, which is uniformly awful for reading, a problem which I’m working on). It’s not limited to tech, either; in book-binding, for example, hot-melt glue is faster and significantly easier for manufacture, and so in mass production has entirely supplanted cold glue, despite producing a vastly inferior result. Does this justify a wistful yearning for the days of old when hearts were twice as good as gold and twenty times as mellow? People on this site are more aware than most of the ubiquity through time of this sentiment. But perhaps this time it’s different? I wonder how many sombre reflectors have thought that. Certainly it’s not new phenomenon for progress to be tempered by inferiority in some regards; further back in history, crossbows successfully replaced longbows, again because of a significantly reduced time to production despite inferior results—but not so inferior as to be useless. Progress is littered with such compromises. Often those compromises are eventually conquered, too: after another couple of centuries, they could make crossbows more powerful than longbows had been.

    书后索引有独特价值但正在消亡,人工索引的技艺面临失传,值得记录与挽救。

    书籍索引确实能做到全文搜索做不到的一些事,但全文搜索也能做到「书后索引」做不到的许多事,尤其是书后索引的质量参差不齐(历来与投入多少资金请专业索引师相关,只是过去出版商更愿意在这方面花钱)。如果只能二选一,你选哪个?其实无所谓,因为你没得选。我不同意文章说索引「不需要拯救」——如果作者指的是它的未来有保障的话。书后索引正在消亡,留下来的也大多质量不高。制作人工索引的专业知识、技能和方法论很快就会失传。我很高兴有人在它消失之前,把它作为一种技术记录下来。

    jrochkind1查看英文原文

    The book index can do some things that full text search can't do, it's true. But full-text search can also do a great many things the "back of the book" style index can't do, especially when quality of back-of-the-book indexes varies highly (generally correlated to how much you could spend on paying skilled expert(s) to create them, and always has; it's just that publishers used to invest more in them, at least sometimes). If you could only have full-text-search or back-of-the-book index, which would you pick? It doesn't matter, cause you don't have a choice. I disagree with article that it "doesn't need saving", if the author meant that it's future is secure. The back-of-the-book index is dying, those that remain are seldom of much quality. The expertise and skill and methodologies of creating manual indexes will soon be lost. I am glad some are trying to document the back-of-the-book index as a technology, before it's gone.

    视频等内容也需要类似索引的导航结构,本质是对观众时间的尊重。

    我希望 YouTube 视频也能这么做。给我看一张场景变化的图示,让我能点进去。太多真人出镜讲话的视频,承诺结尾有什么内容,有时甚至承诺的东西根本不会出现。太好了,你把后院改造成了天堂——让我看看,我自己会判断。我不想在半小时的讲话里快进 30 秒都找不到重点。别浪费我的时间。

    dukeofdoom查看英文原文

    I wish this was done for youtube videos. Show me a graphic of the scene changes. And let me click into them. So many talking head videos with the promise of something towards the end of the video, or sometimes even something that is never deliver. Great, you redid your backyard into a paradise. Let me see it, and I'll be the judge of that. I don't want to fast forward for 30 seconds over half hour of talking. Don't waste my time.

    在快媒体时代,真正专注的读者稀少,索引正是为这类读者服务的工具。

    对比播客、推文、YouTube、Instagram、TikTok 的热度与博客和书籍的热度,就能看出真正的读者有多稀少。

    allenleein查看英文原文

    Compare the popularity of podcasts, tweets, YouTube, Instagram, and TikTok, to blogs and books, to see how rare genuine readers are.

    同类还值得读

    1. 写书:值得吗?

      Writing a book: is it worth it?

      Martin Kleppmann(《设计数据密集型应用》作者)复盘写书到底值不值:金钱回报低、耗时极长,但带来了可见度、信任和职业机会。

      出版与作家生涯2020 · 642 分 · 287 评4 条写作要点编辑精选
    2. 写书并不是个好主意

      Writing books is not really a good idea

      这篇文章讨论靠写书谋生的现实难度,评论区从版税数学、收入预期和写作目标三个角度补充了作者视角。

      出版与作家生涯2021 · 577 分 · 609 评4 条写作要点编辑精选
    3. 如何自助出版一本书:实用资源清单

      How to self-publish a book: A handy list of resources

      这是一份关于「如何自助出版一本书」的资源清单帖,涵盖从编辑、排版到 ISBN、销售渠道的实操工具与花费。

      出版与作家生涯2018 · 558 分 · 88 评4 条写作要点编辑精选
    4. 我自助出版一本Ruby on Rails书,赚了7万美元

      How I Made $70k Self-Publishing a Book about Ruby on Rails

      这是一篇 Ruby 开发者自述:他把一套 Rails 性能课程(书+视频+答疑)自出版,一年毛收入约 7 万美元,并总结了选题、定价、营销等经验。

      出版与作家生涯2017 · 539 分 · 175 评4 条写作要点编辑精选
    5. 石黑一雄警告年轻作家因“恐惧”而自我审查

      Sir Kazuo Ishiguro warns of young authors self-censoring out of 'fear'

      石黑一雄提醒年轻作者因“恐惧”而自我审查,即这条帖子讨论的核心。

      出版与作家生涯2021 · 396 分 · 641 评5 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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