The grand finale

Modern technical writing - Andrew Etter 2016


The grand finale

Having finally finished this book, I'm a bit depressed—turns out everything I know about technical writing can be covered in just over 10,000 words.

The point, I guess, is that technical writing doesn't need to be complicated. Technical writers have just spent several decades convincing people that it should be. No part of the job is easy in execution, but all of it should sound easy in theory:

1. Learn everything about a subject.

2. Write down exactly what an audience needs to know and no more.

3. Make the content beautiful, discoverable, scannable, and searchable.

4. Consider everything a draft, and iterate relentlessly.

5. Make contribution simple.

I wish I had something more all-encompassing to say, something that would tie technical writing into storytelling or poetry or life. But no, technical writing is a job like any other, and I believe this book can help you do it a little bit better.