RE: Benchmarking Technical Documentation

Subject: RE: Benchmarking Technical Documentation
From: ccallen -at- beckman -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 23 Jul 2001 14:37:13 -0700

Wade (and several others) seem to believe Andrew's five questions are,
indeed, golden.

>I made mine into a power point and put it on my wall

> Andrew Plato wrote:
> [snipped]
> When documenting something, you must answer the five golden questions:
>
> 1. What is it?
> 2. What does it do?
> 3. What is its purpose?
> 4. How does it work (or how does it do what it is supposed to do)?
> 5. Why is it relevant?
> [end snip]
>

The first three (and maybe the fifth) are relevant, but can easily be
covered in a few paragraphs in the intro or description section. How it
works is seldom of interest to the user (do I care how my telephone or VCR
works? no). But the most important question isn't even mentioned--HOW DO I
USE IT? That's what user's really, really need to know.

Cheers,
Carma



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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

Learn about tools and technologies for user assistance developers at
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com


---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Benchmarking technical documentation: typos, grammar, content?
Next by Author: RE: Benchmarking Technical Documentation
Previous by Thread: RE: Benchmarking Technical Documentation
Next by Thread: RE: Benchmarking Technical Documentation


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


Sponsored Ads