记一些写作的经验

引子

2019年8月 ~ 2020年8月

和年轻的同事们 合作了一本Web全栈开发的书

由于经验和习惯不同 写作水平和细节把握也参差不齐

因此记录下一些合作过程中的经验 希望能帮助以后的写作

原则

写作是一个长期的事情 唯一的办法就是坚持

每周持续产出: 无论发生什么

写作是OKR 没有KPI 挣得丢得都是自己的脸

更高更细的要求: 表达、措辞、格式、标点符号

写作

杜绝完全的复制粘贴 网文大多是机器翻译

复制粘贴后 表达、措辞要重新组织

使用短句 长句不仅难以理解 而且容易出错

或者函数或者表达式除了返回语句外还与外部世界或者它所调用的函数有明显的交互行为 !!!

使用格式统一的书面语 避免过于口语化

使用缺陷代替Bug