[Nix-dev] Extra manpage per service?

[Bjørn Forsman]

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