Re: Opinions, please: Document by the Component or by the Tab?

["Lin Sims" <ljsims -dot- ml -at- gmail -dot- com>]

*thwaps forehead*

Of course. It's obvious. My only excuse is that it's been a long day for me.

On Tue, Sep 30, 2008 at 3:15 PM, Combs, Richard
<richard -dot- combs -at- polycom -dot- com> wrote:

> Put yourself in the user's place. Would you approach your job by
> randomly picking a tab and then looking to see if it's needed for the
> component you want to configure? I don't think so.
>
> A list of components that a tab is used in is of virtually no use to
> your users. They're going to approach this product from the standpoint
> of "How/where do I configure the XYZ component?" -- not "What can I do
> with the ABC tab?"
>
> Richard
>
>
> Richard G. Combs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help gives you everything you need to author and 
publish quality Help, Web, and print content. Perfect for technical 
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

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.