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

    写作方法2020cs.tufts.edu编辑精选

    设计:一稿完成论文写作与指导的关键(2002)[PDF]

    Design: the key to writing and advising a one-draft thesis (2002) [pdf]

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

    导读

    这是一篇 2002 年的文章,讨论如何在写作前先做设计,从而让学位论文一次成稿,并把这套方法用于指导学生的写作。它值得写作者读,因为它把“写作”从把文字堆出来,重新定义了先把结构、读者和论证链设计好;两则评论分别补充了适用边界和可操作的段落设计法。

    关键词 论文写作结构设计读者意识段落设计

    可以直接用的写作要点

    1. 01

      先完成设计再动笔:把论文当成产品,先把章节与论证链搭好,写作只是把设计实现出来。

    2. 02

      先弄清为谁写:只给自己看时可以粗放速写,要交给读者时才值得打磨得整洁、完整、统一、有说服力。

    3. 03

      用“自由写作”把想法先写出来,再把它压缩成结构设计,不要一开始就追求一次写成的终稿。

    4. 04

      把每个段落当成一个函数:先确认读者需要哪些前提信息才能看懂,再确定这一段唯一要传达的结论。

    HN 评论精选

    “一次成稿”这类经验未必普适;先写后改与先列大纲是两种不同的写作路径,而打磨只对交付给读者时才必要。

    这类建议很像“对我有效,如果你不适用那怪你自己”。写作者大致分两类:一类直接开写,写到哪算哪;一类先列大纲。前者必须经过一次大改或重写。我不认为有人完全不列大纲就能写论文,但也怀疑这套建议的普适性——有些人必须先自由探索想法,然后才能给它结构。即便如此,文中仍有很多好建议,例如:“当你为他们(读者)写作时,你会努力让产品变好:整洁、完整、校对过、统一、有说服力等等。也就是说,你为读者打磨一件设计良好的产品;但如果读者是你自己,这种努力就是浪费。”

    csours查看英文原文

    This really strikes me as the sort of advice where one may say: It worked for me, and if it doesn't work for you it's your fault. Very broadly speaking, there are two kinds of writers: those who just start writing and go where the writing takes you, and those who develop an outline first. In the case of the first set, it is vital to do a heavy editing pass or re-write iteration. I don't think anyone tackles a thesis without some kind of outline, but I also doubt the universality of this advice. Some people need to explore their ideas before structuring them. All that being said, this is full of good advice, such as: "When you write for them (the audience), you put forth effort to make your product good: neat, complete, proffed (sic), unified, cogent, etc. That is, you craft and polish a well designed product for them to read. However, if you [yourself] are the audience such effort is a waste."

    段落可以当函数设计:先定义读者需要的前提(参数),再定义这一段唯一要给的结论(输出)。

    我做了多年软件工程师,现在在写人文学科的硕士论文。几次失败的尝试之后,我自己摸索出的论文设计方法,和作者描述的几乎一样。我把“速写”叫作“自由写作”,我常常设计到主题句这一层,但不是每一段都这样。除此之外,方法相似得惊人。我还习惯把段落看作“函数”:它的参数是什么?也就是读者需要知道什么,这一段才讲得通,我怎样引出这些概念;它的输出是什么?也就是我想让读者从这一段带走的那一件事。(有些段落会返回元组,不过那并不理想。)

    lukebuehler查看英文原文

    I’m writing a master thesis in the humanities right now after having worked many years as a software engineer. After some false starts, I have come up with a system of designing my thesis very closely to what the author is describing here. I call sketching “free writing,” and while I often design down to the topic sentence, I don’t do this for every single paragraph. But other than that my method is uncannily similar to what is described here. I also tend to think of paragraphs as “functions.” What are the parameters? I.e, what does the reader need to know for this paragraph to make sense, and how do I trigger those concepts. And secondly, what is the output? I.e., what is the one thing I want the reader to take from this paragraph? (...well some of my paragraphs return tuples, but that’s not ideal)

    同类还值得读

    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

    关注向阳乔木

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

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

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