On 15-11-19 02:56am, Roger Qiu wrote: > Can the manual be made as a gitbook with the chapters fleshed out better > and made more user friendly? One part of the manual can be very fact > based, another part can be story based. Kind of like the difference between > documentation vs api documentation vs tutorials. I often find myself across > 3 to 4 different blog posts, the arch and gentoo wiki, the nixos manual, > the wiki and github issues because the up to date relevant information is > everywhere.
May I humbly suggest http://stevelosh.com/blog/2013/09/teach-dont-tell/ as a general documentation writing template? -- 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@lists.science.uu.nl http://lists.science.uu.nl/mailman/listinfo/nix-dev