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

    写作方法2012blog.jgc.org编辑精选

    我学到的关于写作的一些事

    Some things I've learnt about writing

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

    导读

    这是博主 John Graham-Cumming 分享写作心得的文章,HN 读者围绕写作指南的选择、技术写作的难点以及"为读者而写"展开了讨论。对写作者的价值在于:学会挑选真正有用的写作参考书、警惕"知识迷雾",并把"站在读者角度"从口号变成可操作的习惯。

    关键词 写作方法读者意识技术写作写作书推荐

    可以直接用的写作要点

    1. 01

      动笔前先想清楚读者是谁,公开写作本质上都是写给别人看的,"为自己写"往往只是自欺。

    2. 02

      警惕"知识迷雾":你懂得越多,越难为不懂的读者写清楚,可试着用同伴视角而非专家视角表达。

    3. 03

      别盲目崇拜 Strunk & White 这类经典指南,其语法建议存在争议,最好搭配更系统的风格书一起读。

    4. 04

      广告业的写作书(如 Writing That Works)擅长把冗长含糊的文字改得简洁切题,同时保住原有语气,值得借鉴。

    HN 评论精选

    别盲目推崇 Strunk & White,其语法建议有争议;推荐一本分析型、一本实操型的写作书搭配使用。

    作为对推荐 Strunk and White 的反驳,请看看《50 Years of Stupid Grammar Advice》——它主要反对的是其中的语法主张,而非风格建议(后者被它称为"乏味但基本无害")。我强烈推荐两本写作书:《Clear and Simple as the Truth》不是标准写作指南,而是对某类清晰有说服力的写作所做的深入分析;《Style: Towards Clarity and Grace》则更偏具体操作。两本都很出色,后者旧版更短反而更清楚。

    telemachos查看英文原文

    As a counterpoint to the Strunk and White recommendation, please take a look at this: 50 Years of Stupid Grammar Advice[1]. (Note that it doesn't primarily object to the stylistic advice in S&W, which it calls "vapid" but "mostly harmless". The real objections are to the grammatical claims and advice.) Two books on writing I strongly recommend: Clear and Simple as the Truth: Writing Classic Prose[2], exerpt here[3]. Style: Towards Clarity and Grace - this one has gone through countless versions as the publisher seems to re-release it every academic year. (Make used copies obsolete and raise the price.) I prefer the older, shorter versions to the more recent ones. It was clearer itself when briefer! Anyhow, here's an author search on Amazon - look for older used copies[4]. Edit: Just found this outline of the 6th ed. of the book. A good way to see what he covers in a hurry.[5] The first is not a standard writing guide; it's a thoughtful analysis of what makes a certain kind of writing clear and persuasive. The second is a more nuts-and-bolts guide to writing. They're both excellent. [1]: http://chronicle.com/article/50-Years-of-Stupid-Grammar/25497 [2]: http://classicprose.com/ [3]: http://classicprose.com/csx.html [4]: http://www.amazon.com/Joseph-M.-Williams/e/B001H6MZ40/ref=ntt_athr_dp_pel_1 [5]: http://www.oxfordtutorials.com/StyleTenLessons.htm

    "知识迷雾"精准概括了专家写作的困境,也说明同伴视角有时比专家视角更利于学习。

    原文说"技术写作的一个风险是我称之为知识迷雾的东西:你对一个主题懂得太多,就很难为知识不足的读者写作"。我从没听过这种说法,但它精辟地总结了要点。我想这也解释了为什么有时从同伴那里学到的东西比从教授(或其他老师)那里更多。

    b_emery查看英文原文

    > One risk with technical writing is what I call the fog of knowledge. You know so much about a subject that it's hard to write for someone who isn't as knowledgeable. Never heard it described that way, but it brilliantly summarizes the point. I think this is why you sometimes learn better from peers than from profs (or other teachers).

    广告业的写作书能有效训练简洁切题的表达,且不牺牲原有语气。

    我最喜欢的写作书来自广告业:Kenneth Roman(前奥美 CEO)和 Joel Raphaelson(前奥美创意总监)合著的《Writing That Works》。它把我冗长含糊的邮件、信件和博客改得简洁切题,同时保住了原文的语气。我还在学习,但书里有大量可操作的具体建议。

    AhtiK查看英文原文

    My favorite book on writing comes from advertising. Two authors, Kenneth Roman (former Ogivly CEO) and Joel Raphaelson (former Ogivly creative director): Writing That Works (http://www.amazon.com/Writing-Works-Communicate-Effectively-Business/dp/0060956437) This book has been transforming my long and vague e-mails, letters and blog posts into more crisp and to the point while keeping the tone of the message. Still learning, the book has tons of concrete advice to follow.

    公开写作本质上是为读者而写,"为自己写"的说法站不住脚。

    关于"想着读者",我常听人说"为自己而写"。真相是:所有说自己在为自己写作的人都在撒谎——如果真是为自己写,他们就不会公开发表了。

    Swizec查看英文原文

    > Think about the reader -> I've often heard people say "write for yourself" Here's the truth, everyone who tells you they're writing for themselves is lying. If they were writing for themselves, they wouldn't publish it publicly.

    同类还值得读

    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

    关注向阳乔木

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

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

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