Re: Concept - Task ratio

Subject: Re: Concept - Task ratio
From: Mike Starr <mike -at- writestarr -dot- com>
To: 'techwr-l List' <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 02 Feb 2011 12:57:52 -0600

I'm not saying grandma should have to plow through the concepts in order to get to the procedure. I'm talking about something similar to what Gene outlined... make the concepts available as related topics. Just don't omit them completely as some companies are doing.

Mike Starr WriteStarr Information Services
Technical Writer - Online Help Developer - Technical Illustrator
Graphic Designer - Desktop Publisher - MS Office Expert
(262) 694-1028 - mike -at- writestarr -dot- com -

On 2/2/2011 12:03 PM, John Posada wrote:
>>> Many companies are adopting the Tivo model that Laura reported
>>> and I feel that's a big disservice to users. If we help them
>>> understand the the why, they'll have an easier time dealing with the how.
> That works in the area of software documentation to professionals in
> the tech field, the kind that we are used to dealing with.
> However, picture your grandmother. She has a phone and the audio sound
> is poor...her granschild sounds garbled when she calls to say hello on
> Sunday afternoon.
> Does she want to read stuff that includes, but is not limited to:
> "Noise interference only affects analog waves; therefore static or
> garbled audio can occur wherever analog waves are used in the system.
> To reduce this possibility, the only section of the telephone system
> that will use analog waves is from the phone port on the device to the
> telephone handset. No matter what setup you have, the signal has to
> get translated to analog waves at some point, or else you wound not be
> able to understand the sound coming out of the phone. "
> or does she want to read
> Step 1 ...
> Step 2 ..
> Step 3 ..
> We aren't adopting it because it's cheaper...on the contrary,
> conceptual material is cheaper to write than procedures.
> We're adopting it because we read several hundred comments per week
> from customers through article feedback and this is what they are
> telling us they want.

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:


Concept - Task ratio: From: John Posada
Re: Concept - Task ratio: From: Mike Starr
Re: Concept - Task ratio: From: John Posada

Previous by Author: Re: Concept - Task ratio
Next by Author: Re: Concept - Task ratio
Previous by Thread: Re: Concept - Task ratio
Next by Thread: Re: Concept - Task ratio

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

Sponsored Ads