On 15-11-24 09:14pm, zimbatm wrote: > Please no XML as the source, it adds way too much emphasis on the structure > instead of the content. > > Asciidoc is pretty good. It can be configured quite close to markdown > <http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#markdown-compatibility-asciidoctor-only> > and supports all the nice things that you need for bigger documents like > TOC, includes, simple macros and list definitions, ...
Not sure how you got from zeal to asciidoc, but two things: 1. The nix documentation is already XML (docbook) 2. Most (if not all) languages export their documentation as HTML What are your proposals, convert all that to asciidoc? How? Why? -- Proudly written in Mutt with Vim on NixOS. Q: Why is this email five sentences or less? A: http://five.sentenc.es May take up to five days to read your message. If it’s urgent, call me. _______________________________________________ nix-dev mailing list [email protected] http://lists.science.uu.nl/mailman/listinfo/nix-dev
