TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> The
> | "user-advocacy" concept assumes that you as a tech writer have some
> unique
> | vision into the mind of users. The truth, you have no better vision than
> the
> | next guy - engineers included. There are plenty of cases where what
> seems
> like
> | a stupid UI decision actually makes sense once you understand the
> engineer's
> | intentions behind the design. Therefore, in a rush to defend the tender
> | sensibilities of the user, it is easy to forget to ask a simple question
> -
> "why
> | did you do that?"
>
I say:
Programmers, engineers, developers, people who actually construct things
must have a very good understanding about the intricacies of the technology
they are using. They must be specialists about the needs of the technology
and they must cater those needs in order to build something that lasts (laws
of physics, hardware, Microsoft, etc). Because of that, their minds are so
focused on the inner workings of what they are building that they have
neither the time nor the objective point of view required to criticize what
they have just built. It is not because they are dumb, it is only human
nature not to be objective about what we create ourselves. It is easier and
faster to get a second opinion than to go into a meditative state to remove
any emotional attachments to the product we built. That's why, I have my
user guides read by people before I send them to the print shop.
It is ok to ask "why did you do that?" but that does not mean that the
answer will be good.