十一 142009
Python的框架工具Django的作者Jacob Kaplan-Moss继续写关于文档对开源技术项目的重要性的帖子,这是第二部分:
我应该成为写作专家,对吗?那么为啥我以前发的帖子中有那么多错误?
答案很简单:我的博客没有请编辑。
博客没有专业的编辑来打理是正常的。但很不幸,这也是开源项目文档的典型现状:大部分的技术文档的开发状态未超出“粗略的草稿”状态。
所有好的作者都有个“肮脏的小秘密”:他们的写作技巧并不都真的那么优秀。只不过是他们的编辑们让他们的作品看起来优秀而已。你对语言的掌握得多好其实不重要;没有人(甚至是语法大师)能在第一个版本就把东西写好。
如果你真的想编写优秀的文档,编辑的功夫不可少。
英文原文


Hacker News