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

    语言与文风2021newyorker.com

    关于那个价值千万美元的牛津逗号的几句话

    A few words about that ten-million-dollar serial comma (2017)

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

    导读

    这篇《纽约客》文章围绕一起因缺少“系列逗号”(牛津逗号)而产生歧义、牵涉千万美元赔偿的劳动法诉讼,讨论标点在真实世界中的分量。它提醒写作者:标点之争往往掩盖了根本问题——句子是否一开始就写得清楚。

    关键词 牛津逗号标点歧义句子改写法律文本

    可以直接用的写作要点

    1. 01

      凡是理解全靠一个容易被忽略的逗号来撑住的句子,都应考虑改写,而不是靠加一个逗号来补救。

    2. 02

      改写的常见手段是用更明确的说法替代纯靠标点的区分,例如增加“配菜是”“甜点是”“随后是”等词,或直接拆成两句。

    3. 03

      如果你要用逗号隔开同位语或插入语,可以改用破折号或括号,这样就能保留系列逗号来消除歧义。

    4. 04

      把歧义句当作可控性测试:如果一句话会引发大量关于“该怎么读”的讨论,那它就是坏句子,而不是读者不够细心。

    HN 评论精选

    像“pan-roasted oysters with a tomato sauce over rice, broccoli salad and bread pudding…”这样高度依赖读者注意一个容易漏看的逗号的句子,本身就是坏句子。与其争论系列逗号这个“创可贴”,不如重构句子,让大多数人不费劲就能一次读懂。这类似代码中“最小惊讶原则”:耍小聪明的写法不该通过评审。他改写为“...rice and broccoli salad, followed by bread pudding with chocolate sauce”,并补充说甜点清楚了,但主菜仍不清楚,所以更愿意在可行处多写几个词(如“with a side of”“dessert”“followed by”)来明确结构。

    seanwilson查看英文原文

    > “The next day, I enjoyed pan-roasted oysters with a tomato sauce over rice, broccoli salad and bread pudding with chocolate sauce.” A comma after “broccoli salad” would have cleared the table before dessert. I think if you write a sentence that's highly dependent on the reader paying careful attention to where an easy-to-miss comma is, you assume all readers know what Oxford commas are, and the sentence generates a lot of discussion about how it can be misinterpreted, it's just a bad sentence. I think instead of debating about Oxford commas as a band aid, you should restructure the sentence so most people will understand it first time without having to think too hard. This feels similar to overly clever code which goes against the principle of least surprise that shouldn't pass code review. “The next day, I enjoyed pan-roasted oysters with a tomato sauce over rice and broccoli salad, followed by bread pudding with chocolate sauce.” Edit: Fair point that the dessert is clear now but not the main. Either way, I'd prefer restructuring the sentence to make it clearer where practical e.g. adding in a few extra words like "with a side of", "dessert", "followed by".

    既有用了牛津逗号反而产生歧义的例子,也有不用它才产生歧义的例子。在我见过的“用了反而歧义”的例子中,句子都含有用逗号隔开的同位语,这才是歧义来源。同位语一般用逗号隔开,但用破折号或括号也完全可以接受:只要给同位语换用破折号或括号,同时一律使用牛津逗号,这些歧义例子基本都能解决。

    tzs查看英文原文

    There are examples where using an Oxford comma makes a sentence ambiguous and there are examples where not using an Oxford comma makes a sentence ambiguous. In all the examples I've seen where using an Oxford comma makes a sentence ambiguous that sentence contains an appositive phrase that is set off with commas and that is what creates the ambiguity. Commas are the most common way to set off an appositive phrase, but it is generally considered acceptable to use em dashes or parenthesis instead. Switch to using one of those instead of commas for your appositives, always use the Oxford comma, and I think that clears up all the ambiguous cases.

    美国宪法第二修正案里的逗号及其含义,牵涉的可能是数万亿美元:私人持枪与枪支暴力的种种成本都取决于个人持枪权如何解读,而标点会让人把原文读成“只有加入管理良好的民兵时才享有持枪权”。更麻烦的是,当年的逗号本来就没有统一标准,各州批准的版本标点各不相同。

    bcatanzaro查看英文原文

    The commas in the second Amendment and their meaning are probably worth Trillions of dollars. When you think of all the private arms and all the costs of gun violence in the US over the years which hinge on the individual right to bear arms, when punctuation in the second amendment can lead people to read the text as only holding a right to bear arms within a well-regulated Militia. Turns out that the commas weren’t even standardized and lots of differently punctuated versions were ratified by the different states. https://en.m.wikipedia.org/wiki/Second_Amendment_to_the_United_States_Constitution

    同类还值得读

    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

    关注向阳乔木

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

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

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