Friday, April 28, 2006

Technical Writing Rule #13

| |

another in a series of rules that all technical writes must know

Engineers are wrong, a lot of the time. Don't assume that what they tell you is truth UNLESS they are the primary person responsible for the discrete piece of code or equipment you are inquiring on.

A really good technical writer will know the system to be documented holistically, and should be able to notice all inconsistencies.

1 comments:

Anindita Basu said...

Sometimes, I wish I could remember this rule every waking second of my work-day. Because, I keep forgetting the rule, and keep getting painfully reminded of it when one engineer says something (read, writes a review comment on a doc I create), and another engineer says something else. I agree with what you said on another post - that engineers are experts of only a discrete bit of a project. Aargh!