"S. King" wrote in message news:kpql3k$33f$1...@dont-email.me...
> I've written and produced a lot of videos over the years for manufacturers
> explaining to customers how to use products. My experience is that they
> do care about accuracy, clarity, usefulness. Typically, I'm dealing with
> rather high-cost stuff. Often I have a committee of engineers who
> designed the gizmo and sales-support people who work with customers who
> use the gizmo checking my work from script to finished video. I have
> frequently been asked to simplify product history and theory of
> operation. The explanation often is that the user base is not very
> technical and not very educated. They want to know which knob to turn to
> make the gizmo do what they want, or on which two test points to put the
> VOM probes and what to do if the reading is out of spec. I realize that
> this is different than writing a text book that purports to explain theory.
You're fortunate to have been able to work on such products. The
most-expensive thing I own (other than my car) is a Pioneer plasma TV. It has
the most God-awful user manual I've ever seen (even worse than those for my
DSLRs). It tells you essentially nothing about how to get the most out of the
set -- and it runs 150 pages!
> Paul is almost certainly right about the needs and motivations of
> manufacturers regarding user manuals. I would add that if enough
> customers complained and/or chewed up support resources that
> cost the manufacturer money, they would change.
But when you point out that good documentation will reduce the number of calls
they have to answer, they're hardly ever interested. It makes no sense.
It seems companies have largely "off-loaded" customer support onto user-run
support groups, effectively sweeping the problem under the rug.
By the way, Linksys (Cisco) has excellent customer support. The techs actually
know what they're talking about, and provide solid information. This is one of
the reasons I buy Linksys products.
> I still believe I am almost certainly right about the reasons for the
> success of your marketing. Because, like you, I am never wrong.
> Ever. That's my story and I'm sticking to it.
Actually, I say that I am hardly ever wrong. But I don't care whether or not
you're kidding. I agree. You should never hide your light under a bushel. If a
courteous approach doesn't work, lay it on the line. (This sometimes works
with men, but never with women.)
One of the nice things about being retired is that you can often say exactly
what you like to a potential employer. Some months after I added a description
of a new feature to the user manual for HDR software, the company's owner came
back to me to redo the entire manual. She got upset when she learned that I
was not thoroughly familiar with the product, and I told her it didn't matter,
because I would pick it up as I went along, with her programmers answering
specific questions as they arose. She didn't like that at all -- especially as
she was offering $50 an hour, which I found more of a bribe than a fair wage.
I told her where to get off.
I understand -- and even sympathize -- with wanting a writer who already
understands your product. In her case, she had a professional photographer who
understood it forwards, backwards, and sideways. But he can't write. His book
on HDR processing has magnificent photos, but is poorly organized and written.
From my perspective, it's easier for a writer to learn a product, than for a
product expert to learn how to write. This is similar to the way William S
Gilbert saw things -- he wanted actors who could sing, not singers who could
act.
The company is still in business, but given how cameras are increasingly
incorporating HDR processing, its continued success might depend on the
quality of its documentation. One of the purposes of documentation is to
minimize the amount of experimentation needed to use the product effectively.
Many companies think it's enough to describe the features. It isn't.