写作方法2013math.andrej.com
二十多位数学家用六个月在 GitHub 上写完一本 600 页的书
Two dozen mathematicians wrote a 600 page book in 6 months on GitHub
导读
这篇帖子讲一群数学家在 GitHub 上协作，半年内写完一本 600 页的书。评论进一步讨论把论文公开到 GitHub、让读者参与改进，对写作者理解公开草稿、协作修改和版本管理很有启发。
可以直接用的写作要点
- 01
把草稿放到公开平台，让读者开 issue、fork、提修正，能把单向审稿变成协作改进。
- 02
不要害怕分享未完成稿或源文件，真正有价值的是想法和持续打磨，而不是格式文件本身。
- 03
用版本控制记录写作过程，提交历史能让协作进度和修改痕迹更透明。
- 04
发布作品时给文件起人类可读的名字，方便自己和读者日后检索。
HN 评论精选
公开论文源文件并接受社区协作改进，能把审稿变成共同创作。
最有趣的建议是：与其只让人评价论文，不如让人参与改进——把论文放到 GitHub，让别人讨论、开 issue、fork、改进并发送修正。听起来疯狂？开源当年也听起来疯狂。说实话，谁会偷你的 LaTeX 源码？有更有价值的东西可偷。如果你有终身教职，可以带头，让研究生教你 git 并把东西公开。不要害怕。
anandkulkarni查看英文原文
The most interesting suggestion, to me: "However, there is something else we can do. It is more radical, but also more useful. Rather than letting people only evaluate papers, why not give them a chance to participate and improve them as well? Put all your papers on github and let others discuss them, open issues, fork them, improve them, and send you corrections. Does it sound crazy? Of course it does, open source also sounded crazy when Richard Stallman announced his manifesto. Let us be honest, who is going to steal your LaTeX source code? There are much more valuable things to be stolen. If you are tenured professor you can afford to lead the way. Have your grad student teach you git and put your stuff somewhere publicly. Do not be afraid, they tenured you to do such things." This is a fascinating idea. I'm curious. If we did this (say, with an upcoming technology paper), would anyone want to contribute?
同类还值得读
被低估的工程技能：把文章写好
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 条写作要点编辑精选