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

    写作方法2021lucasfcosta.com编辑精选

    解释“解释”:说明性写作快速指南

    Explaining explaining: a quick guide on explanatory writing

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

    导读

    这篇文章讲的是「解释性写作」怎么做:作者给出一套写说明文的结构方法,帮读者把复杂的东西讲清楚。对写作者来说,它的价值不在深奥,而在提醒你:讲解的难点往往不是知识本身,而是结构、读者定位和开场顺序。评论区补充了几条更实用的经验,也有一条唱反调的观点值得参照。

    关键词 解释性写作文章结构读者意识说明文

    可以直接用的写作要点

    1. 01

      讲复杂内容时,让文章结构本身尽量简单,这样读者在同一时间只需要应付一个复杂的东西。

    2. 02

      不要用背景和历史开场,先讲清楚「我们要做出什么」这个具体目标,再补来龙去脉。

    3. 03

      动笔前先设想读者是谁:专业背景、经验和语言水平不同,最好的解释也不同。

    4. 04

      写作规则不必死守,比如被动语态在某些地方就是最合适的选择;适度用口语和幽默能拉近距离。

    HN 评论精选

    结构要简单到只剩一个复杂点,并先讲具体目标而非历史背景。

    我喜欢这篇文章,它有一个很重要的总体教训:解释复杂的东西时,讲解本身的结构一定要简单直白,这样读者同时只需要处理一个复杂的东西。对我而言一个具体收获是:我常先用问题的历史开场,好显得有分量,但或许可以试试反过来,先讲我们要完成的具体事情是什么。

    williamkuszmaul查看英文原文

    I like this post. I think it has an important overarching lesson, which is that when you're explaining something that's complicated, it's critical that the structure of the exposition itself is straightforward, that way there's only one complicated thing in the room. One concrete takeaway for me is: I often lead with the history of a problem in order to give it some gravitas, but maybe I'll try the advice of swapping the order up, and starting with the concrete thing of what it is we're going to accomplish.

    没有通用的最佳解释,一切取决于读者是谁。

    我认为最重要的是站在读者的立场上。可惜并不存在对所有读者都最好的解释,这完全取决于读者的专业水平、经验和英语(或其他语言)水平。比如给数学基础扎实的学生教编程,用抽象方式讲函数和递归很容易;熟悉笛卡尔坐标系的学生,从图形编程入手会觉得很好上手。

    truly查看英文原文

    I believe that the most important thing is to put yourself in the shoes of your audience. There is, unfortunately, no single best explanation for all audiences. It all depends on the expertise, experience, level of English/other language of the audience. For example, when teaching programming to students who have a solid background in math, it is quite easy to teach functions and recursion in an abstract manner. Students familiar with the Cartesian plane will find it nice to get started programming by doing graphics programming.

    标准建议之外可以加幽默和口语,别把写作规则当铁律。

    不错,但算是相当标准的建议,写过科学论文或商业提案的人基本都做过这类事。我喜欢加入幽默、用口语来写,这不一定讨所有人喜欢,但多数人似乎还挺受用。我不太信「铁律」,比如被动语态在某些地方其实可能是最好的选择。

    ChrisMarshallNY查看英文原文

    Not bad, but it's fairly standard advice. Basically, anyone that has written a scientific paper or pitch proposal has done this kind of thing. I like to inject humor and write in the vernacular[0]. Doesn't always win me friends, but folks seem to like it, for the most part. I'm not big on "hard and fast rules." I find things like passive voice can actually be the best thing, in places. [0] https://littlegreenviper.com/miscellany/

    唱反调:现实中说服从比解释更能推动人,三段式结构未必好。

    解释事情并不难,讲不好也能靠练习和学几个窍门变好。但在现实世界里,解释基本没什么用;让你占上风的其实是说服力,也就是把人从既有信念里撬动出来、让他们接受你选择的信念。这也许出人意料:它并不靠你把信念解释清楚、然后指望别人自己发现错在哪里,人不是这样运作的。另外他提倡的三段式结构是个坏主意。

    teddyh查看英文原文

    Explaining things is not that hard, and if you’re bad at it, you can get better with practice and by learning a few tricks. But explaining is mostly useless in the real world. What will get you ahead is, instead, the ability to be convincing. That is, to pry people loose from their existing beliefs, and nudge them to adopt beliefs of your choosing. This, perhaps surprisingly, does not involve explaining your beliefs and hoping other people see the error of their ways. People don’t work like that. Also, the three-step structure he advocates is a bad idea, as described here (IIRC): https://www.youtube.com/watch?v=vtIzMaLkCaM

    同类还值得读

    1. 被低估的工程技能:把文章写好

      Undervalued Engineering Skills: Writing Well

      这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。

      写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选
    2. 每行只写一句话:让写作和修改都更轻松的排版法

      Writing one sentence per line

      这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。

      写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选
    3. 书面沟通是远程工作的超级能力

      Written communication is remote work super power

      这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。

      写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选
    4. 如何写出有用的文字

      How to Write Usefully

      保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。

      写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选
    5. 如何写得更清楚、想得更清楚,并学会复杂材料(PDF)

      How to write more clearly, think more clearly, and learn complex material [pdf]

      这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。

      写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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