Re: Use POD for docs! (was Re: HTML)
firstname.lastname@example.org (Evert-Jan Couperus) wrote on 25.01.96 in <Pine.LNX.3.91.960124225427.405Aemail@example.com>:
> On Wed, 24 Jan 1996, Ian Jackson wrote:
> > No. For a keywords-based help system it's very important that the
> > keywords for each document are right. A full-text search, or a search
> > based on summaries or keywords invented for some other purpose,
> > doesn't work at all well.
> Very true. Besides that you will need to agree on a set of keywords to
> be used by the authors. I have seen this shortcoming with a large
> documentation project with a lot of professional technical writers
> involved using freely chosen keywords. Now every week the CD-ROM
> containing the documents is accompanied by an article explaining what
> keyword to use to access a particular article. I think this is not the
> way to go.
I think you're wrong here.
Consistent keywords are for situations where lots of things should have
the same keyword.
This is not what we are trying to do here; we want keywords to return just
a few documents, which means lots of different keywords.