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

    写作方法2012americanscientist.org编辑精选

    科学写作的科学(1990)

    The Science of Scientific Writing (1990)

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

    导读

    这是 1990 年《American Scientist》上的一篇经典文章,讨论科技写作为什么常常让读者读不下去,以及怎样改才更清楚。它值得写作者读,因为它把“写得清楚”从作者自己的感觉,变成读者能不能顺畅理解的问题;HN 上的讨论还顺带质疑:这篇文章本身有没有做到它倡导的标准。

    关键词 科学写作读者意识清晰表达技术写作

    可以直接用的写作要点

    1. 01

      判断文字清不清楚,标准是读者能否顺畅读懂,而不是作者自己读着顺。

    2. 02

      有技术背景的人尤其容易把“我懂了”当成“我写清楚了”,要额外花心思预判读者的理解路径。

    3. 03

      评估一条写作建议是否可信,也可以看提出建议的人自己的文字有没有做到。

    4. 04

      堆砌长句和多音节术语未必显得专业,反而可能增加读者的阅读负担。

    HN 评论精选

    评判写作建议时,作者自己的文笔也是可信度的一部分。

    也许是我标准太高——我习惯读 Orson Scott Card 这类人写的写作指南——但我有点担心:这篇文章本身没有它应该的那么写得好。也许你得用些不必要的多音节语言学术语,科学家才会注意到你,但轮到我决定该多大程度信任这些建议时,这仍让人有点不安。

    Eliezer查看英文原文

    It might be that my standards are too high - I'm accustomed to reading how-to-write books written by the likes of Orson Scott Card - but I'm a bit worried that the article itself isn't as well-written as it should be. Maybe you need unnecessarily pollysyllabic linguistics for scientists to pay attention to you at all, but it's still a bit worrisome when it comes to my deciding how much to trust the advice.

    技术作者常把“自己看懂”误当成“读者能懂”,清晰传达需要专门投入。

    我之前写过一段小小的吐槽,虽然措辞不够漂亮,但想表达的是我对科学写作的一些挫败感,这篇文章把它讲得更清楚。我觉得技术人很容易写完就想着“这对我很清楚”,于是不再多花心思去想别人会怎么读。以写期刊或文章为生的人明白清晰传达想法有多重要,希望这一点能更多地带到技术领域。

    Xcelerate查看英文原文

    I went on a little bit of a mini-rant a while ago (http://news.ycombinator.com/item?id=4680626), which, while not so eloquently worded, attempted to share my frustrations about scientific writing that this article makes much clearer. I think it's easy for technical people to write something and think "well, this is clear to me", so they don't put much additional thought into thinking about how their writing will come across to others. Someone that writes journals or articles for a living realizes how important clear communication of ideas is, and it would be nice to see this carry over into more technical domains.

    想系统学习,可以借助公开的科学写作课程。

    Coursera 上有一门讲科学写作的课程,感兴趣的话可以去看(附链接)。

    luos查看英文原文

    There is a class on coursera going about scientific writing if anyone interested: https://class.coursera.org/sciwrite-2012-001/class/index

    同类还值得读

    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

    关注向阳乔木

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

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

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