[Nix-dev] Real documentation, aka "Let's kill the wiki"

[Profpatsch]

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.