[Nix-dev] Extra manpage per service?

[Anderson Torres]

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 <ivanov.maxim at gmail.com>:
> Totally agree, +1 from me. Having per service documentation makes total sense.
>
> On Mon, Jun 9, 2014 at 11:02 AM, Bjørn Forsman <bjorn.forsman at gmail.com> 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
>> nix-dev at lists.science.uu.nl
>> http://lists.science.uu.nl/mailman/listinfo/nix-dev
> _______________________________________________
> nix-dev mailing list
> nix-dev at lists.science.uu.nl
> http://lists.science.uu.nl/mailman/listinfo/nix-dev