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

    文案与商业写作2017blog.hostedgraphite.com编辑精选

    撰写包容性招聘广告的实用技巧(2016)

    Practical tips for writing inclusive job ads (2016)

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

    导读

    这篇2016年的博客给出撰写包容性招聘广告的实用建议,核心是让措辞面向真正能胜任岗位的读者。评论补充了具体反例:堆砌冷门技术术语、使用“快节奏动态环境”等套话,都会无意中劝退合适候选人。对写作者的价值在于学习如何根据读者调整语言、避免用行话和陈词滥调设置门槛。

    关键词 招聘广告包容性写作措辞受众意识

    可以直接用的写作要点

    1. 01

      写招聘或招募文案时,删掉只有极少数圈内人懂的术语,改用岗位日常真正需要的语言。

    2. 02

      警惕“快节奏、动态环境”这类套话,它们可能传递年龄或文化排斥信号;如果工作确实高压混乱,再如实说明。

    3. 03

      包容性写作不只是避开“忍者/摇滚明星”等标签,还要反思自己是否仍在按某种文化偏好筛选人。

    4. 04

      不要为了显得包容而做表面替换:改数字、把普通词当禁忌,未必有依据,清晰和真实仍是首要标准。

    HN 评论精选

    过度具体的冷门技术要求会筛掉本可胜任的候选人。

    我现在的公司曾招聘“深入了解Python、自己写过Python元类”的人。有多少人能立刻说出元类是什么、为什么要写?我们代码库里确实有一个手写元类,但那是很久以前写的,运行正常,也不需要改;日常工作没人要考虑元类。把这种极冷门知识点写进招聘广告,只会吓跑很多本可胜任的候选人。后来不再提元类,我们招到了一些很优秀、也很好相处的新人。

    jordigh查看英文原文

    At my current job, we used to advertise that we wanted someone with deep knowledge of Python, who had written their own Python metaclasses. How many of you know off the top of your head exactly what a metaclass is and why you would want to write one? While we did have one hand-rolled metaclass in our own codebase, it was just there, written long ago, worked fine, and didn't need any modification. None of us actually working at the job have to think about metaclasses on our day-to-day tasks. By putting that very specific bit of Python arcana in our job ad, we were just scaring away lots of potential candidates who could have done the job just fine. They stopped mentioning metaclasses in the ad and we've gotten some really good new hires since who are very competent, and best of all, are very nice people.

    “快节奏动态环境”这类套话可能传递年龄排斥,除非情况真实否则应删除。

    我补充一条:我一看到招聘广告里有“在令人兴奋/敏捷的快节奏、动态环境中工作”之类的话就立刻忽略,这几乎等于说只招年轻人。当然,如果工作确实混乱高压,这个信号或许应该保留。

    happypants23查看英文原文

    I'll add one - I immediately ignore any job ad that contains anything along the lines of "Work in an exciting/agile fast-paced, dynamic environment", which pretty much signals that only youngsters need apply. Of course, if the job really is chaotic and high-stress, then that signal should probably stay in the job ad.

    包容性写作也要警惕“排除正确标签”的双重标准。

    这篇讲包容性招聘广告的文章仍然想展示自己“排除了该排除的人”:不要忍者、摇滚明星或brogrammer,只要友善关怀的人。我觉得有趣的是:基于文化的歧视显然正确、应普遍适用;而以前的基于文化歧视却是我们都该避免的罪过。我其实喜欢这篇文章,也同意多数写作建议,不是想过度批评,只是觉得这是反思这些习惯多容易冒出来的好机会。

    SomeStupidPoint查看英文原文

    > No ninjas, rockstars or brogrammers, please; just nice, caring humans. I like how in a post about inclusive job ads, they still wanted to show off that they Exclude The Right People. Their cultural based discrimination is obviously correct and should be applied universally; previous cultural based discrimination is a crime we should all strive to avoid! I actually enjoyed the post (and agree with most of the points about writing job postings) and don't mean to be overly critical, I just think it's an interesting chance to reflect on how easily these habits come to us as people. (And so some of the language above is dramatic for effect.)

    对数字和“代码”等词的表面替换缺乏依据,包容性语言不应变成禁词或数字包装。

    原文说“你的代码每秒会被12.5万次事件执行”,改成“你的贡献每天会被超过500亿次事件执行”。为什么125×10^3和50×10^9会影响多元化招聘?博客引用的科学研究并没提到改数字(比如把3个零改成9个零)会更包容。另外,为什么“code”成了包容性禁忌词?女性Ginni Rometty用过“lines of code”,女性Mary Barra也用过“lines of code”。

    jasode查看英文原文

    >original: Your code will be exercised by 125,000 events every second, >revised: your contributions will be exercised by more than fifty billion events per day Why does 125 * 10^3 vs 50 * 10^9 influence diversity hiring? The scientific study the blog references does not mention anything about altering numerical figures (such as altering a numerator from 3 zeroes to 9 zeroes) to be more inclusive. Also, why is "code" a taboo word for inclusiveness? Here's female Ginni Rometty using the phrase "lines of code".[1] Another female (also a non-programmer) Mary Barra using the phrase "lines of code".[2] [1] "New cars today have 100 million lines of code": https://www.ibm.com/ibm/ginni/01_06_2016.html [2] “A car today has hundreds of millions of lines of code,” : http://www.triplepundit.com/2017/07/gm-boosts-stem-education-girls-women/

    同类还值得读

    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

    关注向阳乔木

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

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

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