Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]
- From: Morten Kjeldgaard <mok imsb au dk>
- To: Kim Lester <kim dfusion com au>
- cc: ldp-discuss lists debian org, gnome-doc-list gnome org, recipient list not shown: ;, recipient list not shown: ;
- Subject: Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]
- Date: Mon, 10 Jan 2000 19:15:13 +0100 (CET)
On Mon, 10 Jan 2000, Morten Kjeldgaard wrote:
> A new way of grouping the documentation should be implemented, to make it
> faster and easier to locate the document you need. I very much support
> Kim's ideas:
>
> > The hierarchy should be able to be cross refrernced in at least 3 ways
> > (and also via
> > a word search):
> > By title
> > By problem/concept/
> > By program|module|group name
Technically, the grouping and other information of each document could
easily be encoded in an SGML comment near the beginning of the file for
example:
<!-- Group: software/configuration -->
<!-- Keywords: sendmail:mail:e-mail:Internet Connectivity: -->
These instructions could be used by a script to build the documentation
hierachy in whatever way desired. It should be the responsibility of the
LDP to coordinate with the authors the assignment of group, keywords etc.
/Morten
--
Morten Kjeldgaard <mok@imsb.au.dk> | Phone : +45 89 42 50 26
Institute of Molecular and Structural Biology | Fax : +45 86 12 31 78
Aarhus University | Home : +45 86 18 81 80
Gustav Wieds Vej 10 C, DK-8000 Aarhus C, Denmark | icq : 27224900
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]