[Nix-dev] User-oriented nixpkgs documentation (was: ioquake3 on nixos)

[Jakob Gillich]

> RST is best.

I don't get this attitude. Documentation has to be easy to write, or
very few people will do it. At least 90% of developers know and prefer
Markdown over everything else, even if the syntax has fundamental flaws.

On Sat, Apr 16, 2016, at 01:44 AM, Anderson Torres wrote:
> 2016-04-15 13:54 GMT-03:00 Profpatsch <mail at profpatsch.de>:
> > On 16-04-09 04:10pm, Anderson Torres wrote:
> >> I prefer to start a documentation project, like the FreeBSD
> >> Handbook[1]. It could contain some in-project documentation for every
> >> module too.
> >
> > I proposed a Cookbook a while ago, akin to the Puppet one
> > http://www.puppetcookbook.com/
> >
> > We could write that in Asciidoc or Markdown (or rst).
> 
> RST is best.
> 
> >
> > --
> > 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
> nix-dev at lists.science.uu.nl
> http://lists.science.uu.nl/mailman/listinfo/nix-dev