Writing instruction manuals is an art....
...that few are qualified to practise.
I speak from the depths of yet another design doc that tries its hardest to be everything but. Discursive, digressive, talking about what things are not instead of what they are....
And don't get me started on those "look how smart we are" documents.
But let us also ask why that ever larger tome called "Your car and its features" is 98% warnings and 2% stuff you need to know.
Biting the hand that feeds IT
