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

    文案与商业写作2018uxplanet.org编辑精选

    产品设计中的用户体验文案写作

    UX Copywriting in Product Design

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

    导读

    这是一篇讲产品设计中 UX 文案(界面文案)重要性的文章。它值得写作者一读,是因为评论区把“好文案”的标准具体化了:好的界面文案要能准确说明发生了什么、用户能做什么;换成卖萌语气并不能解决问题。这也能反过来提醒写作者:论点要配得上例子。

    关键词 界面文案错误提示用户视角举例论证

    可以直接用的写作要点

    1. 01

      错误提示要说清发生了什么、是谁的问题、用户能做什么,而不是把技术术语换成“Oops”这类卖萌词。

    2. 02

      避免“稍后再试”这类模糊时间,改成可执行的具体动作,比如“现在重试”“明天再试”或“检查网络连接”。

    3. 03

      别把“让用户点按钮”当成文案目标;文案的目标是让用户明白点击之后会发生什么。

    4. 04

      论点必须有具体例子支撑;如果找不到例子,说明论点还没成熟,应先搁置、长期攒素材再写。

    HN 评论精选

    换掉术语、加语气词不等于好文案,模糊的“稍后再试”依然不可执行。

    我不确定“我们无法打开你的相机”比“相机错误”好多少。普通人怎么会“打开”相机?这同样卡在技术抽象里。而“哎呀出错了!稍后再试!”只是比“请求失败。重试。”更卖萌,没给出任何实质内容。我希望尽责的 UX 设计师会考虑用户怎么读这条信息,并得出结论:“稍后”模糊得没用;“现在重试”或“明天再试”才有用、可执行。现在大家更认可 UX 重要,UX 空话也同比例增加,其中很多并不见得多用心。UI 设计也有类似情况:几十年的人机交互研究摆在那,重设计却更像在追求好看,而不是更好用。

    afandian查看英文原文

    I'm not sure "We couldn't open your camera" is any better than "Camera error". How does a normal person "open" a camera? It's just as stuck in technical abstractions. And "Oops something went wrong! Try again later!" is more cutesy but gives nothing substantial above "Request failed. Retry.". I would hope that a UX designer doing their job properly would think about the user, how they interact with the message, and come to the conclusion that "later" is uselessly vague. "Try again now" or "try again tomorrow" are useful and actionable. There seems to be a lot more appreciation that UX is important and a proportional increase in UX fluff. Not much of it seems to be very thoughtful. I think there's a parallel in UI design. There's decades of HCI research, but redesigns seem to be more concentrating on making things look pretty, not easier to use.

    文案的目标是让用户理解,不是促使用户点击。

    我强烈反对把 UX 写作的目标定为让用户点击“行动号召”按钮。那是营销,不是 UX。好的 UX 文案,目标应该是让用户明白点击按钮后会发生什么。

    gnud查看英文原文

    I vehemently disagree that the goal of UX writing should be to make users click on a "call to action" button. That is marketing, not UX. The goal of good UX writing should be that the users understand what happens if they click the button.

    没有实例支撑的观点显得空洞,写作者应先攒例子再动笔。

    我一直觉得这类文章给出的例子太少。读起来像是作者先想好了主题,再去找例子支撑,结果找不到。也许作者该放弃这篇文章,或者先搁一搁,用更长时间收集例子。能向读者展示你的意思,远比让读者凭空相信你有说服力。

    mosselman查看英文原文

    I always find these kinds of articles, as this one, to have too little examples of the message they are trying to convey. It makes it feel as if the writer came up with the subject first and when they tried to find examples to back up their idea they couldn't find any. Maybe writers should then forget about their article or bench it for later, so that they can gather examples over a longer period of time. It just makes your message so much more compelling when you can show the reader what you mean than asking them to take your word on it.

    拆解一条典型错误提示:卖萌、含糊、无时间、无行动指引。

    我喜欢文章的主旨,但这条提示信息处处是毛病。“Oops!”——请别这样,这让你显得不专业、不知道自己在干什么。“Something went wrong!”——到底出了什么?是我的问题还是你们的问题?我至少想知道有没有我能做的事,比如是不是我没网了、还是你们服务器挂了。“try again later”——later 是什么时候?一分钟还是一天?

    yoz-y查看英文原文

    > Oops! Something went wrong! Could you please try again later? I like the gist of the article but this particular message has everything wrong. - Oops! - please don’t, it makes you look like you do not know what you are doing - Something went wrong! - what exactly? Is this because of me or you? I’d like to at least see if there is something I can do or not. For example whether I do not have internet access or your server is down - try again later... when? In a minute, tomorrow?

    同类还值得读

    1. 好文笔是一种商业优势

      Good writing is a business advantage

      这是广告人 George Tannenbaum 的一篇博客短文,主张清晰的写作在商业中是实打实的竞争优势——能把事情说明白的人,在会议、邮件、提案里就已经赢了一半。

      文案与商业写作2020 · 449 分 · 198 评4 条写作要点编辑精选
    2. 如何为落地页撰写文案

      Writing copy for landing pages

      这是 Stripe Atlas 关于落地页文案的写作指南,核心是把文案当成回答读者疑问的工具,而不是自我表达。

      文案与商业写作2018 · 416 分 · 84 评4 条写作要点编辑精选
    3. 我曾是扎克伯格的演讲稿撰写人

      I was Zuckerberg’s speechwriter

      这篇是第一人称回忆:作者曾为扎克伯格写演讲稿,借此复盘在剑桥分析丑闻前后,科技巨头的公开表达如何被构思、修饰和交付。

      文案与商业写作2018 · 347 分 · 254 评4 条写作要点编辑精选
    4. 一句话产品描述写作的艺术

      The Art of Writing One-Sentence Product Descriptions

      这篇文章讨论如何为产品写一句话描述,核心是把复杂产品压缩成一个能打动人的句子。

      文案与商业写作2017 · 335 分 · 57 评4 条写作要点编辑精选
    5. Ask HN:为技术岗位写求职信

      Ask HN: Writing cover letters for tech jobs

      这篇 HN 讨论科技岗位是否需要写求职信、写给谁看、用什么语气和格式。

      文案与商业写作2017 · 265 分 · 123 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

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

    WeChat

    关注向阳乔木

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

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

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