Orchid XP v8 <voi### [at] devnull> wrote:

> Yes, but WHAT DOES IT DO??!? >_<
>
> Sometimes people are just too close to a project to remember that
> somebody else might not know this crucial information. Without that
> context, the rest often makes little or no sense.
>

Not restricted to software, either. How about microwave ovens?  Or the DVD
player I have? Manuals thick as a magazine, full of tech-speak. Far too often,
it seems that the engineers who create these gadgets are the same ones who
write the manuals.  Great engineers, terrible writers. Especially if the
instructions are originally written in a foreign language, then translated.
OMG!

Ken W.

Post a reply to this message