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

    写作与思考2020timcasasola.com

    为什么写作在远程工作中如此重要

    Why does writing matter in remote work?

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

    导读

    这篇文章讨论为什么写作能力在远程工作中至关重要:远程团队主要靠异步文字沟通,写得清楚的人能推动协作、留下可追溯的记录。对写作者的启发在于,工作写作是一种以读者行动为目标的实用文体,值得刻意练习。

    关键词 远程工作异步沟通实用写作军事写作格式

    可以直接用的写作要点

    1. 01

      写作的核心不是记录自己说了什么,而是让读者清楚知道该做什么、为什么做。

    2. 02

      把请求或结论放在第一句,解释和细节放在后面,尊重读者的注意力。

    3. 03

      即使没人读也要坚持写下来:文字是防止'我们没讨论过'这类扯皮的唯一凭证。

    4. 04

      好的指令要包含'意图'和'期望的最终状态',这样计划出错时执行者仍能自行判断。

    HN 评论精选

    军队的五段式命令是写作清单的典范,核心是写清意图,让执行者在失联或计划失败时仍能正确行动。

    有不少大型开源项目完全靠异步协调,没有任何同步会议。军队非常重视写作:人们写下由他人执行的内容,读者必须清楚理解意图,尤其是在与发送者失去联系的情况下。值得了解军队的'五段式命令'格式——不是因为民间常用,而是它是一份检查清单,确保命令覆盖所有必要内容。特别要注意'指挥官意图'和'期望的最终状态':战斗命令的关键是让人知道为什么要做这件事,因为敌人会'投票'——如果事情没按计划进行,那该怎么办?

    Animats查看英文原文

    There are sizable open source projects which do all coordination asynchronously. There are no synchronous meetings, even online. The military takes writing seriously.[1] People write things which are acted upon by others. The reader needs to understand clearly what is intended. Especially when they are out of communication with the sender. It's worth understanding the military five-paragraph order format.[2] Not because it's used much in civilian life, but because it's a checklist for what must be covered in an order. Note especially "Commander's Intent" and "Desired Endstate". A key point in combat orders is knowing why something is being done. Because the enemy gets a vote. If things don't go as planned, then what? [1] http://tsg3.us/tnsg_lib/pldc_school/wobc/is_1460_materials/ch3.pdf [2] https://en.wikipedia.org/wiki/Five_paragraph_order

    不写下来,口头会议达成的共识很快就会丢失,写作是防止扯皮的唯一凭证。

    我和很多不爱写作的人共事,他们什么都不写,只想开同步会议(电话/当面);我通常在技术团队,这让'口头聊技术'更加痛苦——没人来得及思考,什么也留不下来。 inevitably,过一阵子大家就忘了实际说过什么、达成过什么共识,因为没有文档或追踪(Jira 里只有硬性技术点,其余讨论的内容都没有记录)。我和合伙人写了很多东西,但我们知道没人会读;我们还是写,因为我不想在又一次电话会议里听到'但我们没讨论过这个!'时陷入抓狂。

    tluyben2查看英文原文

    I work with many people who are against writing; they never write anything and they only want to do sync meetings (phone/in person); I am on the tech team usually which makes that even more painful as 'talking through tech' is a horrible thing. Nothing sticks as everyone needs time to think about things. Inevitably, after a while, you get people losing track of things that were actually said, that were actually agreed on etc because there are no documents or that kind of tracking for that matter (there is stuff in Jira, but that's only following the hard tech points, not all the rest that was also discussed). My business partner and me write a lot but we know nobody is going to read it; we do it anyway because I don't want to end up with a feeling of insanity in yet another phone call with 'but we did not discuss that!'.

    邮件写作技巧:请求放第一句,解释和细节放后面。

    写邮件时,把你的请求放在第一句。你是想从对方那里获取信息?还是想让对方做某事?放在第一句。然后把解释和细节放在邮件其余部分。

    insickness查看英文原文

    Whenever you compose an email, put your ask in the first sentence. Do you want information from them? Do you want them to do something for you? Put it in the first sentence. Then put the explanation and details in the rest of the email.

    写作能力应成为招聘标准,滥用'语音聊吧'和为开会而开会是低效的信号。

    我非常喜欢异步沟通。下次找工作面试时我会考察对方的写作能力。我已经被会议拖垮了,'我们语音聊吧'这类话被严重滥用。我参加过主题是'讨论下次会议讨论什么'的会议,荒谬至极。

    dkdk8283查看英文原文

    I absolutely love async communication. I’ll look for writing competency when interviewing at my next job. I’m bogged down in meetings enough as is. Phrases like “hey let’s talk voice” is abused heavily. I’ve been to meetings where the topic was to discuss what to do in our next meeting. Absurd.

    同类还值得读

    1. 不要想好再写,要写来思考

      Don’t think to write, write to think

      这篇短文主张不要把写作当成思考完成后的记录,而要把写作本身当作思考的工具:动笔的过程会逼出想不清楚的地方。

      写作与思考2022 · 553 分 · 145 评4 条写作要点编辑精选
    2. 写作即思考:学会自信地写作

      Writing Is Thinking: Learning to Write with Confidence

      这是一篇讲“写作即思考”的博客:作者认为写作不是把想好的东西誊写出来,而是借助写作本身把想法想清楚,因此写作者应当建立信心、敢于先写烂稿。

      写作与思考2019 · 529 分 · 83 评4 条写作要点编辑精选
    3. 如何用写作来思考

      How to think in writing

      这篇文章讨论的是「用写作来思考」:作者认为写作不只是把想清楚的东西表达出来,更是想清楚本身的工具——文字落在纸上,你才有机会看见自己思路里的跳跃、含混和漏洞。

      写作与思考2024 · 424 分 · 120 评4 条写作要点编辑精选
    4. 写作,帮你逃离默认的人生设置

      Write to Escape Your Default Setting

      文章的核心主张就写在标题里:写作是帮你逃离「默认设置」的手段——日常的思维和表达都有惯性默认的默认模式,而落笔能逼你跳出来,重新看清自己到底在想什么、要说什么。

      写作与思考2025 · 407 分 · 93 评4 条写作要点编辑精选
    5. 写作就是思考

      Writing is thinking

      文章以“写作即思考”为题,讨论写作不只是把已有想法记录下来,而是帮助澄清、组织和推进思考的过程。

      写作与思考2025 · 330 分 · 128 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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