[Nix-dev] [RFC] Generating documentation from nixpkgs (markdown files) with pandoc (Was: Real documentation, aka "Let's kill the wiki")

Domen Kožar domen at dev.si
Thu Nov 19 20:13:24 CET 2015


After the discussion at https://github.com/NixOS/nixpkgs/issues/1960 I've
lost hope to reach a consensus.

I'll maintain Python related documentation in restructured text separately
from nixpkgs manual since the docbook tooling we have is a real disaster.

I hope that doesn't discourage others to try :)

On Thu, Nov 19, 2015 at 6:55 PM, Colin Putney <colin at wiresong.com> wrote:

>
>
> On Wed, Nov 18, 2015 at 9:51 AM, Domen Kožar <domen at dev.si> wrote:
>
>> I've once experimented and ported nixpkgs manual to
>> http://static.domenkozar.com/nixpkgs-manual-sphinx-exp/
>>
>
> Wow, that looks great! This kind of thing is much nicer than the docs
> currently on the web site. With everything in one page it's hard to find,
> link to and search for specific sections that have the information you
> want. This solves that problem nicely.
>
>
>> But there doesn't seem to be of a much interest to make documentation
>> more approachable (something we did with github for code)
>>
>
>  Isn't this thread an expression of interest?
>
> Colin
>
> _______________________________________________
> nix-dev mailing list
> nix-dev at lists.science.uu.nl
> http://lists.science.uu.nl/mailman/listinfo/nix-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.science.uu.nl/pipermail/nix-dev/attachments/20151119/187b132f/attachment.html 


More information about the nix-dev mailing list