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

Reply via email to