Mailinglist Archive: opensuse-doc (23 mails)

< Previous Next >
Re: [opensuse-doc] Indexing question
  • From: Clayton <smaug42@xxxxxxxxx>
  • Date: Tue, 19 Jun 2007 10:57:15 +0200
  • Message-id: <e29967880706190157o3b70cb48o17afb795611da810@xxxxxxxxxxxxxx>
I'm the index obsessed doku-wichtl.  The lack of indexing drives me crazy.
Searching turns up every reference to a word, but doesn't focus on what is
important.  This is why we use XML for our docs so our PDFs can still have
indexes.

I agree... search tools work, but then you have to wade through
hundreds or even thousands of irrelevant hits to find the 2 that
apply.  That's where good indexing really shines.

I can only speak for myself and for LfL: If you create an indexterm in
one of our DocBook sources, it will create an index both in online and
print formats.

That works great when you're dealing with DocBook or other XML source
material where you have the ability to add index tags where you think
is important.

I'm trying to experiment and implement other methods of collecting and
producing books - basically trying new approaches to traditional doc
methods.  One I'm working on right now is Wiki.  I know, Wiki is a
collaborative tool, not a doc tool... but I'm experimenting and trying
to look for other ways to encourage community involvement in
documentation.  Right now, the sources I work with are in a custom XML
format that has a very high entry threshold.  Wiki was requested as
the lowest common denominator... so I'm working on that now.  This
means adding in new functionality etc to the Wiki to even have a hope
of making it work... and I'm trying to cover all angles of traditional
doc functionality in teh process.  Thus the question about indexes.
:-)

I'll have a think about your comments here... maybe I'll have a
brainwave today :-)  One can hope... right?


C.
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >
References