Book & Man

提供高效率的技术出版、培训和咨询服务

关于编写优秀的文档(第二部分):你需要一位编辑

without comments

Python的框架工具Django的作者Jacob Kaplan-Moss继续写关于文档对开源技术项目的重要性的帖子,这是第二部分:

我应该成为写作专家,对吗?那么为啥我以前发的帖子有那么错误

答案很简单:我的博客没有请编辑。

博客没有专业的编辑来打理是正常的。但很不幸,这也是开源项目文档的典型现状:大部分的技术文档的开发状态未超出“粗略的草稿”状态。

所有好的作者都有个“肮脏的小秘密”:他们的写作技巧并不都真的那么优秀。只不过是他们的编辑们让他们的作品看起来优秀而已。你对语言的掌握得多好其实不重要;没有人(甚至是语法大师)能在第一个版本就把东西写好。

如果你真的想编写优秀的文档,编辑的功夫不可少。
英文原文

分享此帖:
  • Print
  • Digg
  • del.icio.us
  • Facebook
  • Google Bookmarks
  • Haohao
  • HelloTxt
  • Identi.ca
  • Reddit
  • RSS
  • 豆瓣

Written by Chuancy

十一月 14th, 2009 at 11:46 下午

Posted in General

Leave a Reply