Re: Extremes

Subject: Re: Extremes
From: "Michael West" <mbwest -at- bigpond -dot- net -dot- au>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sat, 21 Dec 2002 07:28:15 +1100


"Andrew Plato" wrote

> I have wild, ludicrous ideas like:
>
> Prioritize your efforts!
>
> 1. Accuracy
> 2. Completeness
> 3. Relevance
> 4. Insight
> 5. Sell more products
> ...
> 692. Fonts
> 693. Dirt under your nails
> 694. STC competitions

Thank you for ignoring the virtue of
"completeness" by omitting the other 686
priorities.

Seriously though, the problem is that
"completeness" is relative. Too much
detail can be a hindrance.

If by "completeness" you mean "an appropriate
level of detail based on analysis of audience needs",
then I think you'd be right on the money. If, on
the other hand, you mean "inclusion of all the
technical details regardless of their usefulness
to the end user" then I think you've described one
of the most common failures of documentation
written by programmers who have been asked to
write.

--
Mike W
Melbourne


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

---
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.


References:
Re: Extremes: From: Andrew Plato

Previous by Author: Re: Extremes
Next by Author: Re: Quick Reference Rules
Previous by Thread: Re: Extremes
Next by Thread: RE: Extremes


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

Sponsored Ads


Sponsored Ads