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

    写作方法2022brevity500.com编辑精选

    Brevity 500:用小游戏帮你成为更强的写作者

    Show HN: Brevity 500 – Short games to help you become a powerful writer

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

    导读

    这是作者做的 Brevity 500 小游戏:给你一段啰嗦的原文和几个必须用到的词,限时把它改写得简洁清楚,用来练习非虚构写作(销售、市场、技术写作)。HN 评论既肯定了“被迫动手改”的练习价值,也提出一个关键反驳:简洁不等于质量,砍到骨头也可能变得生硬。写作者可以从中得到关于删减、改写练习和评判标准的具体启发。

    关键词 简洁写作改写练习商务沟通写作训练

    可以直接用的写作要点

    1. 01

      先弄清写作目的和读者,再决定删到什么程度——简洁只是手段,砍过头会让文字变得生硬做作。

    2. 02

      最常见的写作毛病是填充词、绕来绕去的长句、观点不清和跑题,改稿时优先消灭这几样。

    3. 03

      练改写时把原文和限制条件(必用词、字数、语气)放在眼前,逐句对照范文,看它到底改动了什么。

    4. 04

      给自己加约束练快写(限时、限字数)能逼出干货,但先在不计时的情况下练熟,再加时间压力。

    HN 评论精选

    简洁不等于质量,砍得太狠会牺牲清晰和自然,写作目的决定该删多少。

    我不认同把“简洁”等同于“质量”。营销和商务沟通里确实有种风气,把一切砍到只剩骨架,然后称之为高质量。但这往好了说也是过度简化:不是每篇文章目的都相同,当下这股崇尚简洁的风气目标是清晰,实际却常常写出僵硬生硬的文字。

    Peritract查看英文原文

    I don't agree with equating brevity and quality. There's a definite trend in marketing/business communication to cut everything down to the bare bones and call that quality. At best though, this is an over-simplification. Not every piece of writing has the same purpose, and the current fashion for brevity aims at clarity but often hits stilted instead.

    练习时要能对照原文和限制条件;范文应给多个合格版本和反例,而不只一个标准答案。

    恭喜上线。这东西很酷,也有点吓人——我大概就是目标用户:我早就知道自己职场最大的短板是沟通,其中“简洁”正是要学的。我做了一个“药房化学”题,感觉非常难受,说明它真的有效。写作时我只好把原文复制到旁边窗口对照,如果能固定显示原文和必用词会更好。另外,比起只给一个“标准答案”,我更希望看到几个都合格的改写版本,再加几个不合格的例子——对一个自认写作差的人来说,知道该做什么和不该做什么都有用。

    loxias查看英文原文

    0. Congrats on shipping. 1. This is really cool. Also scary. I think I might be the target market for this, I've long known that communication is my greatest professional weakness at this point, and within that, brevity is something I gotta learn. 2. I did one of the games (CVS, pharmacy, chemistry) and it was terrifying! By which I mean "I think I might be exactly the sort of person who needs to be FORCED to do this, and I did so, and it was DIFFICULT AND UNCOMFORTABLE", which means your thing works. :D 3. I had to copy the original text to a side buffer so I could refer to it while I was writing. It would have been better if I could see it, and the required words, on one part of the screen (left? top?) while I entered my new text somewhere else. 4. The timer didn't seem to work for me (firefox, linux), but that's fine, there's no way I could have gotten it done in time, and seeing the numbers decrease would have made it even harder. ^_^;; 5. I understand that "grading" in any sense is hard (you need a human), so I appreciate offering the example "correct" response, but you know what would have been even better? several "valid" rewrites, and perhaps a few that aren't! What I mean to say is, as an admittedly poor writer, seeing both an example of what to do and what not to do could be of use. 6. I wish there were a way to spend 1/20th as much for 1/50th of the paid product first, before committing to buy the whole thing. There's a large psychological difference between $5 and $100 and I'd pay $5 right now to test out the paid version 10 times, even though I'll probably pay $100 for it, later. I might not though! I might forget! But that made my brain hurt so hard I'd drop $5 without a thought. 7. A difficulty level for each game would be FANTASTIC! Can you do that? Perhaps just 3 levels. That way people like me who are looking to take their writing ability from "completely horrible" to "acceptable" can have an easier time.

    写作通病是填充词、复杂句和跑题;先练准确表达,再考虑加时间压力。

    想法和执行都很好,这些题目光当作“问题陈述”来读也有用:每道题都明确了想要的语气和目标,示例答案还配了解释。无论技术写作还是创意写作,我见过的主要问题都是多余的填充词、没必要的复杂句,以及难以清楚表达重点、容易跑题。两个建议:编辑器上方放一份高亮关键词的原文;计时器不一定有用,可能让人怕超时而写得草率,可以先不设计时,等练熟了再加。

    reifyx查看英文原文

    I think both the idea and execution are great. These games would be useful even just as problem statements. I like that each problem clearly defines the desired tone and goals, and that the sample solutions have explanations. Both in technical and creative writing, I agree that the main issue I've seen is unnecessary filler words, needlessly complicated sentences, and a difficulty clearly expressing the point and staying on-topic. Some ideas - A copy of the original text with highlighted words above the editor might be nice - Not sure if the timer is helpful, might cause people to do a poor job for fear of running out of time. Could start without a timer and add it in as users get more practice

    练习的评判标准要透明,并且要能同时看到原文、自己的答案和范文,才看得出改写的门道。

    概念上我很喜欢,但实现上有些困惑:一开始看不出所有“游戏”都能玩,还以为是每日挑战;说明文字冗长重复,欢迎、背景和规则完全可以放在同一屏。既然开始前就能看到原文,限时其实没意义——我大可以先在记事本里慢慢写好。另外,判定答案是否合格的规则(比如是否用 AI)不清楚,明明用上了所有必用词却被判无效,也不知道该怎么改。最后,完成后能看到自己的答案和目标答案对比,却看不到原文,无法比较“原文→目标答案”到底改进了什么。

    elefantastisch查看英文原文

    Conceptually, I really like this. Congratulations on getting it out there, and thank you for sharing. The implementation confuses me though. It's not clear at first that all "games" (though I would think it's rounds of a single game, not distinct games) are available rather than this being some kind of daily challenge. The instructions are very drawn out and repetitive. There's no reason the Welcome, Background, and Rules couldn't be on one screen. The Mission page should just be merged with Rules. The time limit seems pointless given that you get to see the text before the game starts. You could just write your text in Notepad using as much time as you want. I would either get rid of the timer (greatly preferred) or stop showing the text in advance (if you must). It's not clear what other rules (AI?) are being used to judge whether a response is valid, so when you get marked invalid even though you're using all the required terms, it's not clear what you're supposed to do to make it valid. It would be nice to be able to review the Background section of the instructions while writing. After completion, you see your response compared to a target, but you can't see the original anymore to compare target vs original to see how the target improved on the original.

    同类还值得读

    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

    关注向阳乔木

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

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

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