Why not to do it in a form of Info pages, too? Info docs are a bit unsupported on Nix...
2014-06-29 20:13 GMT-03:00 Max Ivanov <[email protected]>: > Totally agree, +1 from me. Having per service documentation makes total sense. > > On Mon, Jun 9, 2014 at 11:02 AM, Bjørn Forsman <[email protected]> > wrote: >> Hi all, >> >> I've been messing around with the nixos 'graphite' service lately. I >> thought the module was a bit thin on the documentation side, so I >> started to search online. I came across this graphite puppet >> module[1], and what struck me is that there is no way that our current >> "man configuration.nix" can provide that kind of detail for each >> service, without being completely unreadable. >> >> So, how about we add a manpage for each service.<name>? I think it >> would be a good idea to still have everything in man >> configuration.nix, although "man nixos-service-TAB-TAB" would probably >> be just as easy to navigate. >> >> Does that sound like a good idea to you? Is it easy to do? I don't >> know where to begin :-) >> >> [1]: https://forge.puppetlabs.com/dwerder/graphite >> >> Best regards, >> Bjørn Forsman >> _______________________________________________ >> nix-dev mailing list >> [email protected] >> http://lists.science.uu.nl/mailman/listinfo/nix-dev > _______________________________________________ > nix-dev mailing list > [email protected] > http://lists.science.uu.nl/mailman/listinfo/nix-dev _______________________________________________ nix-dev mailing list [email protected] http://lists.science.uu.nl/mailman/listinfo/nix-dev
