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

Re: documentation which is now officially listed as 'stalled'

>   * How to get started on a new SGML-based manual
>   * Debian Documentation Guidelines
>       -- these should both be incorporated into debiandoc-sgml 
>          manual and tossed from the page, IMHO
>       -- would involve removing debiandoc-startup and sgmltools-startup
>          from CVS area, as well as ldsample.tar.gz ddsample.tar.gz

I'm not sure I agree the guidelines should be incorporated.  These
have nothing to do with the debiandoc-sgml itself, but more with how
the documentation should be written (for instance, using debiandoc-sgml).
If we switch to another DTD and/or set of tools, the guidelines should
still be applicable. 

Integrating the "How to get started ..." is a good idea.  I've already 
copied the ddsample.ta.gz as well as printed the proposed TOC.  I was
already planning on extending the debiandoc-sgml manual, so this might 
be a good starting point. 

> Here's packages that got moved down cause there's nothing substative
> there yet. I'm trying to more clearly distinguish between ready
> manuals and not ready manuals, basically.  Unlike stalled manuals,
> these really should be written, IMHO.
>   * Debian Book Suggestions
>   * Debian META Manual
>   * Debian Dictionary

These still have me listed as author.  Could that be made blank or
whatever, since I orphaned them.  This also applies to the User
Reference Manual, the System Administrator's Manual, and the Network
Administrator's Manual. 

> Here's the packages no longer listed as maintained in the DDP CVS
> area.  Oliver, I've removed these from the manuals.sgml/Makefile but
> not actually removed the files.  You might remove the files if you
> care to and agree...
>   * Debiandoc-SGML Markup Manual 

Although not maintained within the DDP CVS are, it probably still
would be nice to have it on the pages, together with the gidelines
(see above).  Maybe we simply have to put it under the DDP CVS
instance so I can update it when a new release of debiandoc-sgml is


Ardo van Rangelrooij
home email: avrangel@flevonet.nl, ardo@debian.org
home page:  http://www.tip.nl/users/ardo.van.rangelrooij
PGP fp:     3B 1F 21 72 00 5C 3A 73  7F 72 DF D9 90 78 47 F9

Reply to: