Re: Third-party books

Subject: Re: Third-party books
From: Richard Evans <infodex -at- IX -dot- NETCOM -dot- COM>
Date: Thu, 20 Apr 1995 17:02:43 -0700

You wrote:

>One perspective that I haven't seen mentioned:
>While a software is being produced, there is limited time to explore
>understand how to apply the product to practical situations. There is
>usually only time to understand how the product functionally, which is
>so many product manuals are organized by menu items instead of by

>After the product ships, there is time to apply the product to
>tasks and produce documentation that is more task-oriented and
>I've purchased stacks of aftermarket books for products I use
>such as Microsoft Excel, because eventually there is some particular
>I want to do that is not addressed in the original manual as an
>task, for example, how to write a VBA macro that transfers dates from
>Excel to Microsoft project.

>So, I don't view these books as primarily a way to get documentation
>pirated software, although I'm sure they are used for that purpose. I
>don't fault the writers of the original product documentation for not
>able to become expert in 100% of the product and document every
>task before the ship date. This does not, of course, excuse product
>documentation that is just plain poorly done; but I've never been able
>learn a complex piece of software thoroughly without third-party

>Glenn Crumpley

I tried to post just that thought when this thread started, but I have
had trouble getting my replies posted. I think I have the bugs out

Yes, I have been in that exact position: The writer of original
manuals, pressed for time, interacting only with product developers, no
contact with users, producing documentation that is more
feature-oriented than task-oriented. Later on, other writers see the
thing in use, study how it is being used, and write books from the user

For example, a manual for a word processor might describe how to format
a paragraph, make a hanging indent, and add a bullet, but never connect
all that under a topic of "bulleted lists." Along comes the
third-party writer who notices that people who use word processors
frequently have to piece together these bits of information so he
reorganizes the text and groups all the related information under the
recognizable task of "making bulleted lists."

Dick Evans

Previous by Author: A Good Word for Word 6
Next by Author: Re: Is the list really slow?
Previous by Thread: Third-party books
Next by Thread: Third-party books

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

Sponsored Ads