Re: "Making the Most of Service Manuals"

Subject: Re: "Making the Most of Service Manuals"
From: Ned Bedinger <doc -at- edwordsmith -dot- com>
To: Dan Goldstein <DGoldstein -at- riverainmedical -dot- com>
Date: Wed, 09 Apr 2008 21:16:36 -0700

Dan Goldstein wrote:
> The article I just read isn't available for free online, so you'll have
> to take my word for it. It was published in the Association for the
> Advancement of Medical Instrumentation (AAMI) publication "Biomedical
> Instrumentation & Technology."
>
> Among the points raised in the article:
>
> * Apparently, some customers actually read the manuals!

This contrasts very nicely with the claim that no one reads the manuals.
Thanks, Dan, for posting about it. It interests me that the
professionals who use manuals are a different class of audience from
some of the users we write for.

I posted here a few years ago about what I learned from interviewing
medical professionals (sonographers) while writing a manual for medical
diagnostic ultrasound equipment.

To recap and add my 2 units of currency, they blew me away with their
requirements, which conflicted directly with many of my precepts about
technical writing.

Specifically, they WANTED telegraphic writing. They used manuals to
refresh their knowledge about specific procedures.

IOW, the manual prompts existing knowledge from long-term storage into
working memory. Sentences and paragraphs interfere with their communion
of mind's memory and manual's prompts.

My audience analysis guidelines now account better for the audience's
knowledge.

Where I once let their knowledge guide the content I needed to include,
it now guides content AND EVEN the number of words needed to couch
information. Definitely not paragraphs, probably not sentence. Best is
phrases.

I did hear from others on the list who disagreed about ever using
telegraphic style. But I prefer to be a heretic if the alternative is to
forego such clear directives from audience.

YMMV,

Ned Bedinger
doc -at- edwordsmith -dot- com


> * The technicians and engineers who use medical devices create and share
> online lists of available service manuals, in order to have access to
> up-to-date documentation.
> * Expensive, advanced medical equipment is often sold with a single
> printed manual (and no electronic backup). Resold equipment often has no
> manual at all.
> * Some companies charge their customers separately for manuals, instead
> of including them for free with the medical device. (Personally, I think
> this is short-sighted.)
> * Some companies provide manuals online as public, unencrypted PDF
> files. Others provide manuals only to technicians who have attended
> training sessions.
> * The disadvantages of electronic (vs. print) publication seem to affect
> the company more than the user.
>
> Since there are some STC officers on the list... Having read the
> article, I highly recommend that STC offer to pay AAMI for the rights to
> reprint it in an STC publication.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Follow-Ups:

References:
"Making the Most of Service Manuals": From: Dan Goldstein

Previous by Author: Re: Actionable
Next by Author: Re: Actionable
Previous by Thread: "Making the Most of Service Manuals"
Next by Thread: Re: "Making the Most of Service Manuals"


What this post helpful? Share it with friends and colleagues:


Sponsored Ads