#171955 doc-base: Allow grouping and ordering of documents within groups

#171955#5
Date:
2002-12-06 08:29:49 UTC
From:
To:
I was just looking at the W3C documents using "doc-central", and find
that it lists them in alpabetical order by document title.  That is
not the most logical presentation order for that particular group of
documents.  In fact, it is quite annoying, since I really don't know
where to begin reading!  The similar will hold true for many people, I
feel certain.  The whole point of doc-base is to make it easier to
find the fine manuals, so let's improve that situation pronto.

What I propose is to add an optional tag to to a document's entry in
doc-base that declares it as a member of a related group of documents,
and gives it's relative rank amoung them.  This is in addition to the
directory categorization that already exists, in case an entire small
group of documents logically belongs in a more general catch-all
category.

The display engines, such as the excellent "doc-central", could then
use this information to present the document information in a more
logical fashion.  It could indicate that they are all part of the same
document set, and it could list them in rank order.  When more than
one document is given the same rank, they should be listed in title
alphabetical order within that rank group.  Perhaps it would be good
if doc-base provided a tool that would return the list of documents in
this order somehow, in a form useable by any of the document catalog
display engines?

I would also like to see improvements and standardization of the
document directory heirarchy, but that belongs in another wishlist bug
report, along with a request for implementation of a "swish++" based
search engine...  Perhaps I'll write that; I'm working on one for our
LUG site.

Also, will you please see to it that the "debian-doc@lists",
"doc-central@packages", "dwww@pkg", and "dhelp@pkg" (any others?) get
a copy of or link to this BTS entry?  I leave this in your capable
hands, since I am reporting via "reportbug" rather than email, and it
does not provide the option to add Cc headers.