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.
> Would I be correct in assuming that you mean "_manual_
> indexing" doesn't make sense because of the volume of the work
> and the difficulty of indexing something "on demand, in real time"?
> If not, I think you've missed the point of indexing:
Actually, I was thinking mostly about full text indexing, but I think the
comment applies to concept indexing just as much. Actually generating an
index in a mechanical process that is performed on a finished file.
Providing data for the indexing process is a different question.
In our system every component in our database has an index field in which we
list index terms for the component. If we needed to manage variant
terminology, we would use markup in that field to designate terms from a
control list of variant terms so that we could substitute the right terms
into the indexing field as a preprocess step before building the indexes.
But the only point I was trying to make is that no matter how you manage
your index data in your source, you cannot usefully generate an actual index
from that data except as part of the process of building a particular
information product from it. In other words, the index of an information
product cannot exist prior to the information product itself.
This means that dynamically generated information products cannot have
indexes in the traditional sense. My point is that this should not be seen
as a problem because an index is simply a means of providing an alternate
vector into an information set (other than linear scanning). Dynamic
generation of information is also a way of providing an alternate vector
into an information set. Dynamic generation and indexes do the same job. I
can park my car in the stable because I don't need to keep a horse anymore.
On the other hand, simple substitution of terms into an otherwise static
document does not constitute an adequate degree of dynamic generation to
obviate the need for an index. Thus my suggestion to regenerate the entire
document, including index, each time the docs are customized.