Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]
- From: "Nelson_Ingersoll" <ningersoll mail codenet net>
- To: Kim Lester <kim dfusion com au>, Morten Kjeldgaard <mok imsb au dk>
- CC: <ldp-discuss lists debian org>, <gnome-doc-list gnome org>, "recipient mail codenet net list not shown": ;, "recipient mail codenet net list not shown": ;
- Subject: Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]
- Date: Mon, 10 Jan 2000 12:38:05 -0700
Morten,
I agree that the now artificial segregation of HOWTOs and mini-HOWTOs should be abolished. I also like your suggestions about the indexing/grouping of the HOWTOs.
- Nelson Ingersoll
---------- Original Message ----------------------------------
From: Morten Kjeldgaard <mok@imsb.au.dk>
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
>
>
>--
>To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
>with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
>
>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]