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

    出版与作家生涯2014thedailybeast.com

    小说家维克拉姆·钱德拉痴迷于写代码

    Vikram Chandra Is a Novelist Who’s Obsessed with Writing Computer Code

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

    导读

    这篇报道介绍小说家 Vikram Chandra 对写计算机代码的痴迷,并借评论讨论他的书《Geek Sublime》以及编程与写作的相通之处。对写作者来说,值得读的是其中关于清晰、优雅和结构的问题:代码要让读者一眼看懂意图,写作同样如此。

    关键词 写作与编程清晰表达叙事结构优雅

    可以直接用的写作要点

    1. 01

      写专业或技术题材时,先用浅显章节把背景讲清楚,让外行读者也能进入。

    2. 02

      每一段都应让读者清楚它想做什么、怎么做,不要把意图藏在含糊表达里。

    3. 03

      优先追求优雅简洁的方案,而不是临时拼凑的“将就”做法,表达和功能往往都会更好。

    4. 04

      回忆录或散文合集式结构需要贯穿线索和让读者关心的主体,否则读者容易中途流失。

    HN 评论精选

    回忆录若缺乏让读者关心的主体,且结构像松散文集,容易让人中途放弃;面向外行的基础说明则有用。

    还有别人读过吗?我读到大约三分之二就放弃了,部分因为这是一部关于一个我始终没兴趣的人的回忆录,部分因为感觉像一本散文合集。话虽如此,开头几章讲计算机如何运作,对不太了解这方面的人很有用。

    jgrahamc查看英文原文

    Has anyone else read this? I gave up about 2/3 of the way through, partly because it was a memoir about someone I never got interested in and partly because it felt like a collection of essays. Having said that the introductory chapters which describe how computers work are good for someone who doesn't know much about that.

    好代码和好写作都要求读者能从文本本身看清意图与做法,并追求优雅而非将就。

    《Sacred Games》已加入阅读清单。我会去书店翻翻《Geek Sublime》再决定。另一篇采访里关于他较早作品的引文说:有时你回头看六个月前写的东西也会感到困惑。所以程序员的工作就变成:一个人应当通过看某段代码,准确理解它在试图做什么、以及它如何做到。再进一步是,如果你能做得优雅,而不是一个“jugaadu”(将就凑合)的解决方案。通常这也会带来更好的功能。

    keithpeter查看英文原文

    Sacred Games is now on the reading list. I shall have a look at Geek Sublime at a bookshop and decide then. Quote about an earlier book from another interview... "Sometimes even you can look at something you wrote six months back and be baffled. So the programmer’s job becomes that of, “a person should understand, by looking at a particular section of code exactly what it’s trying to do and exactly how it’s doing it”. One step beyond is that if you can do something elegant rather than a jugaadu solution. Often that also leads to better functionality." http://www.livemint.com/Consumer/5tzbaP50JGO5bAfqZBPOzI/Code-writing-is-very-reassuring-Vikram-Chandra.html

    同类还值得读

    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

    关注向阳乔木

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

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

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