Jacob Kaplan-Moss

Tag: Editing

Writing Great Documentation: You need an editor

I’m supposed to be this expert on writing, right? So how come my previous articles have had so many errors?

Simple: my blog doesn’t have an editor.

That’s typical for a blog, but it’s unfortunately also typical of open source documentation: the vast majority of technical documentation doesn’t reach far beyond rough draft status.

All good writers have a dirty little secret: they’re not really that good at writing. Their editors just make it seem that way. It doesn’t matter how well you’ve mastered the language; nobody, even grammar geeks, gets this stuff right on the first pass.

November 12th, 2009 • documentation editing editors writing