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

Bug#175064: DocBook XML conversion is read with this script



Bill Allombert <ballombe@debian.org> writes:

> I am concerned that DocBook is much too complex to be used for Debian
> policy.  We need to people to write patches without trouble and we do
> not have many editors available for fixing the XML. Debiandoc-SGML
> virtue is that it is simple.

They seem essentially identical to me?  We've had copyright-format in the
Policy distribution for a while, and it's never seemed any different to me
(as someone not horribly familiar with XML markup) from editing Policy.

The alternative, I guess, would be to use Markdown for the whole thing,
but I think it's worthwhile to have sections and internal links and a bit
more formatting than Markdown gives us.

Anyway, my understanding (see earlier messages in this bug) is that the
maintainer of DebianDoc-SGML is actively trying to transition people away
from it, so I think it's not viable to stay on it even if it's better
along some axes.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>


Reply to: