写作方法2022eugeneyan.com编辑精选
回答“为什么、是什么、怎么做”，把文章写得更好
Writing better by answering why, what, how
导读
这篇短文提出一个写文档（尤其是技术文档）的通用框架：先回答“为什么”（动机与价值），再讲“是什么”，最后讲“怎么做”，让读者在读细节之前先明白这事跟自己有什么关系。评论区的讨论把同一套思路延伸到了邮件和广告文案，对任何需要说服别人读下去、采取行动的写作者都适用。
可以直接用的写作要点
- 01
动笔前先写清“为什么值得读”：价值、收益、影响，再展开“是什么”和“怎么做”，别让读者自己猜意义。
- 02
每讲完一个“是什么”，紧接着补一句“所以呢”：它省了多少成本、解决了什么问题，否则事实本身几乎没有意义。
- 03
写完做一次“替换测试”：把其中的主体（公司、项目、产品）换成竞争对手的名字，如果依然成立，说明你的表达不够独特、没有信息量。
- 04
写邮件或请求类文字时用固定四段：发生了什么、我需要你做什么、什么时候要、有问题随时问。
HN 评论精选
用“是什么 + 所以呢”两段式，逼自己写出事实背后的意义。
一个好用的技术写作套路是：1）先说“是什么”（你做了/观察到/打算做什么）；2）再解释“所以呢”——没有这一层，“是什么”几乎没有意义（比如它把运营成本降低了多少）。我常常太专注于“是什么”而忘了“所以呢”，但这个简洁的措辞能帮我把后者一直记在心上。（我最早在 Doumont 的小书《Trees, Maps and Theorems》里见到这种说法。）
532nm查看英文原文
A neat guide for good technical writing goes as follows: 1. Tell the 'WHAT' (i.e what you have built/observed/intend to do/etc.) 2. Explain the 'SO WHAT' without which the WHAT is almost meaningless (i.e. that it reduces operating costs by X/.../etc.) I often find myself focusing too much on the WHAT, neglecting the SO WHAT. However, the succinct phrasing helps me to also keep the SO WHAT in mind. (I first stumbled upon this way of phrasing things in the neat little book 'Trees, Maps and Theorems' by Doumont)
换个主体名字还成立的文案，说明缺乏独特性，是无效表达。
很棒的忠告，我喜欢这种近乎算法的配方。说到写作，顺便分享我写广告文案的检验标准：我能把公司或广告主体换成某个竞争对手，而文案依然成立吗？如果能，说明这个卖点不够独特，通常就是烂文案。一个非常傻的例子：一家叫“Joe 的家庭房屋”的中介，文案写“在 Joe 这里，我们卖最好的房子，用最低的价格让你住进合适的家”——太泛了，把 Joe 换成任何同行都成立。更好的一版是：“在你这片街区长大的 Joe Smith，不仅帮你找到下一个家，他可能还和你上过同一所高中，对这个镇子了如指掌。”
rawoke083600查看英文原文
Brilliant advise ! Well done, I like the almost algorithmic recipe here. Speaking of writing, (sorry for slight high-jack) when writing your "ad copy"(yes I know it's the devils work, especially on HN). But since we sharing writing tips :) Here is my ad-copy tip and litmus test Can I exchange company/ad-subject with one of my competitors and does the copy still make sense ? If yes then the ad/sales-argument is NOT unique enough and usually bad. Super Stupid example: You own an "Estate agency called Joe`s Family Homes and your ad-copy is: "At Joe's We, Sell the best houses and get you in the right home for the lowest price" Meh... Very generic and you can exchange "Joe" for any of your competitors and the ad will still be true and make sense (and be crap). A 'better version' might be: "Joe Smith (From Joe's Homes), who grew-up in your neighbourhood will not only get you in your next home, he probably went to high school with you and knows the in's and out of this town"
邮件也可套用同样的结构：现状、请求、截止时间、开放提问。
类似地，我老板教我用同样的思路写高效邮件：1）现在发生了什么；2）为了处理这件事，我需要你做什么；3）我最晚什么时候需要；4）关于以上内容，欢迎随时提问。
quartesixte查看英文原文
In a similar vein, my boss taught me to apply a similar strategy for writing effective emails: 1) Here’s what’s happening 2) This is what I need from you to address what is happening 3) This when I need it by. 4) Happy to answer any questions about the above.
同类还值得读
被低估的工程技能：把文章写好
Undervalued Engineering Skills: Writing Well
这篇文章讨论为什么“写得好”是被低估的工程能力，以及它如何在团队协作、系统设计和职业发展中持续带来回报。
写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选每行只写一句话：让写作和修改都更轻松的排版法
Writing one sentence per line
这是 Derek Sivers 的一篇短文，主张写作时每行只放一个句子，而不是按段落排版。
写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选书面沟通是远程工作的超级能力
Written communication is remote work super power
这篇文章讨论远程工作中书面沟通的价值，评论区则补充了异步与同步沟通的适用场景，并提醒读者：备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。
写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选如何写出有用的文字
How to Write Usefully
保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式：有用≈重要×新颖×正确×清楚，任一项为零，整篇文章就等于零；他还主张敢下确定判断、删掉让自己心虚的句子。
写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选如何写得更清楚、想得更清楚，并学会复杂材料（PDF）
How to write more clearly, think more clearly, and learn complex material [pdf]
这份 PDF 讨论如何把文章写清楚、把思路理清楚，并用写作来学习复杂材料。
写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选