[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: HOWTO vs mini-HOWTO [was: Linux Doc Infrastructure]



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
>
>


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org