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

    博客与个人写作2010davidbarneswork.posterous.com

    Kathy Sierra 去哪儿了?——或者说,史上最好的技术写作博主

    Where in the World is Kathy Sierra? -- Or, the best tech writing blogger ever

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

    导读

    这篇文章在追问科技写作博主 Kathy Sierra 的下落,并回顾她为何被视为最好的技术写作者之一。评论补充了她淡出 Twitter 的近况,以及她最核心的写作理念:一切表达都要围绕读者和客户的成就展开。对写作者来说,这是一次重新思考“到底为谁而写”的提醒。

    关键词 技术写作以读者为中心博客写作清晰表达

    可以直接用的写作要点

    1. 01

      把句子的主语从产品换成读者:与其写“我的产品很牛”,不如写“我的产品让客户变得很牛”。

    2. 02

      动笔前先问“读者读完能做成什么”,而不是“我想展示什么”。

    3. 03

      像 Kathy Sierra 那样追求“把一切都讲清楚”,清晰本身就是对读者的尊重。

    4. 04

      读优秀写作者的作品时,拆解他们如何以读者为中心组织表达,而不只是模仿文风。

    HN 评论精选

    她的写作核心是以客户为中心:把焦点从产品转移到读者或客户的成就上。

    Kathy 关闭 Twitter 账号并不是因为发生了什么坏事;这与她博客关闭时遭遇的那些不幸威胁不同。参与社区和对话的方式有很多,她只是想暂时离开那个平台。我无法给出公开链接,因为这是从私下交流中得知的,不过她的朋友也发过一条公开推文谈到这件事。总之,她的作品非常棒,从工程师到营销人员都应该吸收她以客户为中心的理念,这些理念让一切都变得清晰:“你的产品并不牛……你的产品让你的客户变牛……”

    thesethings查看英文原文

    Kathy did not close her Twitter account due to anything bad (unlike the unfortunate threats that coincided with her blog shutting down.) There are lots of ways to participate in communities and conversations, and she wanted to step away from that one for a bit. I can't point to a public URL as I got this from private conversation, but there was a public Tweet from one of her friends on this as well. In any case, her work is GREAT and anybody from an engineer to a marketer would do well to absorb her customer-centric philosophies that make EVERYTHING clear ("your product doesn't kick ass... your product makes your CUSTOMERS kick ass...") Google and learn :D

    同类还值得读

    1. 我坚持每天写一条 TIL,已经写了一年

      Show HN: I've been writing daily TILs for a year

      这篇展示作者一年每天写 TIL(Today I Learned)并整理到 GitHub 仓库的做法。

      博客与个人写作2016 · 819 分 · 150 评4 条写作要点编辑精选
    2. 如何写出开发者愿意读的博客文章

      How to write blog posts that developers read

      这篇(正文与评论未提供,仅从标题判断)讨论面向开发者写技术博客的方法:怎样让忙碌的工程读者愿意点开、读下去并读到结尾。

      博客与个人写作2025 · 603 分 · 154 评4 条写作要点编辑精选
    3. 博客写作风格指南

      A blogging style guide

      这是程序员兼博主 Robert Heaton 的博客写作风格指南,用几十条简短规则讲如何让技术文章更清晰、更好读。

      博客与个人写作2018 · 495 分 · 188 评4 条写作要点编辑精选
    4. 十年职业博客写作,我学到了什么

      Ten years of professional blogging – what I’ve learned

      这是作者回顾十年专业博客写作经验的总结,评论补充了写作作为深度学习、聚焦主题、保护写作习惯和选择发布平台等实践。

      博客与个人写作2017 · 362 分 · 126 评4 条写作要点编辑精选
    5. 十年博客写作教给我的事

      What I learned in ten years of blogging

      这是一篇博客作者十年写作经验总结,核心观点是写作的价值在于持续积累而非单篇爆款。

      博客与个人写作2018 · 356 分 · 162 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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