写作方法2016github.com编辑精选
用 GitHub diff 对比《独立宣言》初稿与定稿
US Declaration of Independence first and final drafts as GitHub diffs
导读
这个帖子用 GitHub diff 对比《美国独立宣言》的初稿与定稿，把历史文献的修改过程变成可逐行查看的版本记录。写作者可以从中看到：初稿到定稿不是一次完成，而是大量措辞、删改和归属选择累积的结果；同时也提醒我们，版本记录应忠实反映真实修改，而不是混入误操作。
可以直接用的写作要点
- 01
把初稿到定稿的每次修改都保留下来，写作学习不只看最终文本，也要看删改轨迹。
- 02
版本对比要区分有意的措辞修订与误删、误加，否则会误导读者对写作过程的理解。
- 03
涉及历史或事实的写作，应核对修订顺序、改动数量和每次改动的归属，避免把后人错误当成原始过程。
- 04
逐行 diff 能暴露措辞选择如何一步步累积成最终风格，适合用来复盘自己的改稿过程。
HN 评论精选
版本对比应忠实反映真实修订过程，区分有意修改与误操作，并尽量注明每次改动的来源。
这个仓库历史里有很多提交看起来是仓库创建者本人的真实笔误。例如“that among these are life, liberty, and the pursuit of happiness”这一行曾被意外删除，又在下一个提交中加回。一个声称展示《宣言》各版草稿的项目，却包含完全时代错位、纯属意外、与真实起草过程无关的 diff，这很荒唐。实际上，杰斐逊先写了一稿（仅存片段），然后写了与我们所知文件非常相似的“原始粗稿”。在独立投票前有47处改动，之后到7月4日正式通过又有39处。我希望看到这个 git 仓库准确反映片段、原始草稿、全部86次修订（尽量按顺序并尽可能注明归属）以及作为 Dunlap Broadside 出版的最终版本，而不是这堆时代错位的东西。
phasmantistes查看英文原文
There are a lot of commits in the history of this repo that seem like actual typos on the behalf of the creator of the repo. For example, the line "that among these are life, liberty, and the pursuit of happiness" was accidentally removed here[1], and re-added in the next commit here[2]. It seems silly to have a project purporting to be various drafts of the Declaration to contain diffs which are entirely anachronistic/accidental/have nothing to do with the actual drafting process. It turns out[3] that Jefferson wrote a first draft (of which only a fragment survives), then wrote the "original Rough draft" which is very similar to the document we know. 47 alterations were made before the vote for Independence, and 39 more between then and the official adoption of the document on July 4th. I'd really like to see a version of this git repository accurately reflecting the fragment, original draft, all 86 revisions (in approximate order and attributed as well we can), and final version published as the Dunlap Broadside, instead of this anachronistic heap. [1] https://github.com/usgov/forget-the-king/pull/1/commits/f9ff3ee2d0e53633e7cb5a374d3cd875894315cc [2] https://github.com/usgov/forget-the-king/pull/1/commits/d041db6716fc0789cd83cbf7234337de8304375d [3] https://www.loc.gov/exhibits/declara/declara3.html
同类还值得读
被低估的工程技能：把文章写好
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 条写作要点编辑精选