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.
Subject:Re: When should I add index terms? From:Brian Bertrand <bertran -dot- de -dot- st -dot- jean -at- gmail -dot- com> To:"techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 14 Apr 2010 16:01:57 -0400
If you index as you go, it also provides a handy snapshot as to the progress
of the project as well, and can give you an idea of what things may be
missing that need to still be addressed. I build glossaries/acronym guides
as I go as well, which is a handy by-product for government if nothing else!
On Wed, Apr 14, 2010 at 3:59 PM, Phillips, Wanda <wanda -dot- phillips -at- philips -dot- com
> LOL, rigorous about the content. Here are some examples:
> > each topic needs at least 1 entry
> > index concepts
> > include important abbreviations and acronyms
> > index the tasks using gerunds
> -----Original Message-----
> From: McLauchlan, Kevin [mailto:Kevin -dot- McLauchlan -at- safenet-inc -dot- com]
> Sent: Wednesday, April 14, 2010 12:19 PM
> To: Phillips, Wanda; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: When should I add index terms?
> What kind of rigorous rules?
> About the content, or about being diligent?
> The former, I'd like to hear about.
> The latter... not so much. :-)
> > -----Original Message-----
> > From:
> > techwr-l-bounces+kevin -dot- mclauchlan=safenet-inc -dot- com -at- lists -dot- techwr
> -l.com [mailto:techwr-l-bounces+kevin.mclauchlan<techwr-l-bounces%2Bkevin.mclauchlan>=safenet->
> inc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Phillips, Wanda
> > Sent: Wednesday, April 14, 2010 2:07 PM
> > To: techwr-l -at- lists -dot- techwr-l -dot- com
> > Subject: RE: When should I add index terms?
> > I also index as I go. Aside from having rigorous rules about
> > indexing, I regularly generate a copy of my index to fix
> > inconsistencies and provide guidance for future entries.
> > Wanda
> The information contained in this message may be confidential and legally
> protected under applicable law. The message is intended solely for the
> addressee(s). If you are not the intended recipient, you are hereby notified
> that any use, forwarding, dissemination, or reproduction of this message is
> strictly prohibited and may be unlawful. If you are not the intended
> recipient, please contact the sender by return e-mail and destroy all copies
> of the original message.
> Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
> produce desktop, Web, or print deliverables. Just write (or import)
> and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com
> - Use this space to communicate with TECHWR-L readers -
> - Contact admin -at- techwr-l -dot- com for more information -
> You are currently subscribed to TECHWR-L as bertran -dot- de -dot- st -dot- jean -at- gmail -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
>http://www.techwr-l.com/ for more resources and info.
> Please move off-topic discussions to the Chat list, at:
In Service to the Dream,
Brian C. Bertrand
SKA-Bertran de Saint Jean
Cross-sectional studies show that 100% of Russian Roulette players surveyed
had suffered no ill effects from participation.
More conservative longitudinal studies indicate the same, although it should
be noted that these studies had a high attrition rate, with 16% of
respondants being unavailable for the follow-up survey.
A bullet, laser beam, missile or charge may have your name on it, smartbombs
and bombs are addressed "To whom it may concern"..
Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial: http://www.doctohelp.com
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-