TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
True, you might not consider looking at "Changing", but others might,
and what's the difference. Let them find it under the verb, but also
the item that the verb is acting on. Wouldn't it, in actuality, go
something like this:
Change
Item's Class
Owner Security
Report Schedule
Class
Change
Items
Change Class
Modify
See Change
Owner
Change Security
Permissions
See Security
Report
Change Schedule
Schedule
Change
Security
Change
> >If I'm using this index and I want to know how to change a
> report's
> >schedule, I'm going to look under "report" or "schedule"... but
> definitely
> >not under "changing." (Even worse are the cases where a lazy
>
> First of all, it's a fatal error on the part of an indexer
> to assume that readers are going to look things up the way
> *you* would look them up. You want to provide as many alternate
> ways of looking up a concept as are reasonable, using xrefs if
> you don't want to duplicate short entries.
>
> As for including verbs, often different products use different
> names for roughly the same thing (e.g., what's called a "report"
> in your product may be called a "summary" in someone else's),
> so readers could easily prefer to look up the verb and then see
> what noun in the subentries matches their mental concept. Also,
> some people think in actions rather than nouns: if what they
> want to do is change something, they're going to look under
> "changing."
__________________________________________________
Do You Yahoo!?
Yahoo! Shopping - Thousands of Stores. Millions of Products. http://shopping.yahoo.com/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY. http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Take XML and Tech Writing courses online! Our instructor-led courses
(4-6 hrs/wk) give you "hands on" experience at your convenience. STC members
get 20% off! http://www.online-learning.com/index.html.
---
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.
