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

Re: Blessing DocBook/XML for Debian documentation?

On Sat, Aug 20, 2005 at 11:44:39AM +0000, W. Borgert wrote:
> Hi,
> http://www.debian.org/doc/ddp says "We use DebianDoc SGML for
> our documents", and the policy says the same.  However, more
> and more documents in and for Debian are in fact written using
> DocBook/XML.  My plea is to officially allow DocBook/XML.

There is already documentation in Docbook/XML (the repository-howto,
the "Debian Library Packaging Guide" and the "XML SGML policy")
so I would say that Docbook/XML is allowed in the DDP as long
as the packages that are used for HTML generation are available
in our stable release (the servers which build up the CVS of the DDP
are running stable).

There's really no reason why Docbook/XML shouldn't be used if the
document requires it. Most documents use Debiandoc-sgml because
they don't require the features that Docbook/XML can provide
(tables, figures, etc.). They could be "prettier" if they used
Docbook/XML instead of Debiandoc-sgml but the markup of the former
is easier to learn.



Attachment: signature.asc
Description: Digital signature

Reply to: