[Nix-dev] Fwd: Wiki is dead

[Vladimír Čunát]

On 02/23/2016 12:18 PM, Rok Garbas wrote:
> docbook is just something that is not known by majority of our community

My personal opinion is that this is mostly an excuse. It's a XML subset
and everyone should know at least a bit of (X)HTML or similar stuff.
Note that for almost all docs we use ~10 types of tags and the format is
by itself human-understandable. (Typically it's enough to copy fragments
from a few paragraphs around and edit to have the new content. We might
also compose a list of tags with examples on what we typically use them
for.)

In any case, once the HQ content is produced, conversions are easy
enough; regardless of doing them at build-time as the trend is now or at
commit-time (if we decide later to unify to docbook, for example).

--Vladimir


-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 3771 bytes
Desc: S/MIME Cryptographic Signature
Url : http://lists.science.uu.nl/pipermail/nix-dev/attachments/20160223/40c3b554/attachment-0001.bin