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

    语言与文风2011groklaw.net

    谷歌在甲骨文案中的专家报告用通俗英语解释复杂问题

    Google's expert report in Oracle case explains complexities in plain English

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

    导读

    这篇讲的是 Oracle 案中 Google 专家报告如何用平实英文解释技术复杂性。它值得写作者读,因为它示范了怎样用耐心、类比和通俗语言,让非技术读者也能理解专业争议。

    关键词 平实英文类比读者意识技术解释

    可以直接用的写作要点

    1. 01

      面对外行读者,先补足必要背景,不要默认对方懂行话。

    2. 02

      用贴切的类比降低理解门槛,帮助读者抓住复杂概念的核心。

    3. 03

      用具体例子和对比说明细微差异,避免只给抽象结论。

    4. 04

      把复杂论点压缩成可读段落,让法官、陪审团和媒体都能快速理解。

    HN 评论精选

    用类比和耐心解释复杂概念,连非技术读者也能理解相似代码的实质差异。

    在这份令人印象深刻的文件中,Astrachan 教授还显示出极大的耐心。他一路用精彩的类比解释了一大堆概念,而这些对技术读者本来未必需要。第13-16点用约400词说明:两段看起来相似的 abs 代码,其实可以像 Math.abs 的两种不同实现那样截然不同;从没写过代码的人甚至会疑惑,为什么两者都使用 public、static 等词。

    espinchi查看英文原文

    In this impressive document, Prof Astrachan also shows that he has an infinite patience. He explains (with great analogies) a huge pile of concepts along the way, which wouldn't be necessary for a technical audience. The points 13-16 explain in 400 words that even if public static int abs(int i) { return i >= 0 ? i : -i; } and public static int abs(int a) { return (a < 0) ? -a : a; } look similar, they are as different as two different implementations of Math.abs can be. Someone that has never seen a line of code could wonder how come they both use the words public, static, etc.

    平实英文能让法官、陪审团和媒体更好理解主张,是专业写作的有效策略。

    哇,这份文件写得极好。我希望其他律师也能用这种“平实”英文写作。假设(希望如此)这能让法官、陪审团和媒体更好地理解主张,你们觉得这份文件会显著帮助 Google 吗?

    tsycho查看英文原文

    Wow. This is an extremely well written document. I wish other lawyers would write in such "plain" English. Assuming (hopefully) that this leads to a better understanding of the claims by judges, juries as well as the media, do you folks see this document significantly helping Google in this case?

    同类还值得读

    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

    关注向阳乔木

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

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

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