How to Write Great Documentation

Address the reader’s needs in the simplest way!

That’s it, I could stop now and publish this post already. There is no big secret to write great documentation, that’s all you have to do.

Then, why are there so many poor docs that make you fall asleep, skip them or lose focus? I’ll tell you why. It’s because:

• we’re lazy
• we’re writing for ourselves
• documentation isn’t properly structured
• the writing doesn’t sound natural