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

[Vladimír Čunát]

On 11/21/2015 01:59 AM, Mathnerd314 wrote:
> On Wed, Nov 18, 2015 at 7:04 AM, Hajo Möller wrote:
>     "Documentation should teach, not tell."
>     As Rok said, handing somebody who is learning a new language a
>     dictionary would not help them learn.
> 
> This is wrong. You can do fine with a dictionary and a few months [...]

When we're diving into such analogies, I firmly believe that
dictionaries and similarly reference documentation are also very useful,
but they aren't considered optimal as the only resource for beginners
(the focus of Rok's talk).

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/20151121/e9c4417f/attachment-0001.bin