How to Write Technical Documentation

Let’s be honest with Armen here:

If you could really write programs that worked properly, you wouldn’t need a tech writer to tell your users what you really meant the program to do, and to tell them how to fix up the mess when it doesn’t do it.

And if you think you do that already, that’s because you can’t write or talk to users, which is no great surprise.

Or if you could really code things properly, you could just write a compiler for the requirements specs and go home early the first time it happens. (No second time needed.)