OpenAI 发表了一篇《怎样才算好文档》的指南，很值得学习，最核心的一点：写文档是一种同理心的体现

很多开发者在写文档的时候估计都没有站在阅读这些文档的开发者的角度去思考这个问题，比如大家吐槽良多的支付宝的文档、微信的开发文档😂

里面有几个要点：
- 让文档易于“扫读” → 标题要清晰、段落要简短、多用项目符号和粗体
- 写得简单点 → 少用行话、避免缩写、即便是“显而易见”的步骤也要解释清楚
- 提供“通俗易懂面向普通人”的帮助 → 文档不只是给专家看的，而是给所有人看的
- 按价值排优先级 → 优先解决常见问题，避免教人坏习惯

完整文档：http://t.cn/AXwJnnNr
翻译：http://t.cn/AXwJnnNd