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

Matthias Beyer mail at beyermatthias.de
Wed Nov 18 15:52:08 CET 2015


On 18-11-2015 15:04:30, Hajo Möller wrote:
> As mentioned in another thread, Rok Garbas proposed to remove the wiki
> and replace it with "real documentation". I fully support this.

Me too.

> 
> "You should never tell somebody to read the source."
> Even though the source code should be self-explanatory (and often is,
> see the files in nixpkgs/lib for well-commented examples), having real
> documentation in the form of a manual helps keep everything in the same
> place. This way there can be a single location where users come to when
> they are lost.

Keeping everything in one place is a good idea, though we really
should be careful about nix (language), nix (pkg manager) and nixos
mixing. These confused me the first time I dived into the topic.

-- 
Mit freundlichen Grüßen,
Kind regards,
Matthias Beyer

Proudly sent with mutt.
Happily signed with gnupg.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
Url : http://lists.science.uu.nl/pipermail/nix-dev/attachments/20151118/587d2029/attachment.bin 


More information about the nix-dev mailing list