RE: Looking for classes in indexing

Subject: RE: Looking for classes in indexing
From: "David Artman" <david -at- davidartman -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 30 Jul 2018 10:39:08 -0700

Aside from 'spotting gotchas' that others have mentioned, I've put
indexing to very good use in the past for *targeted reviews of changes*.

For instance, if a "User Story 123456" resulted in my changing 15
topics, then I would add an index entry like so:
<indexterm>!User Story<indexterm>123456</indexterm></indexterm>

Resulting in:
!User Story
123456 25, 28, 30-32, 50, 256

Alternately, if I had another driver of change, like a specific
developer's design document or a feature name, Id use:
<indexterm>!Annie Devvie</indexterm>
<indexterm>!Feature<indexterm>Fooing bars for

The result being that I could put out an Adobe Shared Review PDF for a
whole team, for weeks of development, and they could quickly jump
through the additions and changes using all (and only) the index entries
that pertain to them.

Then just comment out the 'review-tracking' index entries after approval
(and remove any change highlighting--the index helps *me* find those
later!) and they no longer appear... BUT, I still have, in the working,
source files themselves, searchable unique strings if I ever have to
lookup what caused me to change what, when.

Kinda powerful, if you don't already have other significant
change-tracking controls (CMS history, dev-item-tracking app, etc). And
even if you DO, you can 'audit' in just your file stack, using search:
no need for complex queries in other tools and correlating their results
to your file stack. One Stop Shop, so to speak. :-)


-------- Original Message --------
From: "Wright, Lynne" <Lynne -dot- Wright -at- Kronos -dot- com>
Date: Thu, July 26, 2018 5:12 pm

Can you elaborate on how indexing is a good way to review your work?
Visit TechWhirl for the latest on content technology, content strategy and content development |


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-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Previous by Author: RE: callout colors - for black-background screenshots ?
Next by Author: Re: Looking for classes in indexing
Previous by Thread: RE: Looking for classes in indexing
Next by Thread: Re: Looking for classes in indexing

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

Sponsored Ads