On Sat, 14 Jan 2017 at 11:32:09 -0800, Russ Allbery wrote: > Bill Allombert <ballo...@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. [...] > 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.
asciidoc, then? Or Markdown with pandoc extensions? asciidoc is another wiki-like language, but has semantics defined in terms of Docbook rather than HTML. Pandoc's Markdown dialect includes footnotes and explicit or implicit anchors in headings. S