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

2015-11-23 Thread Joachim Schiele
On 18.11.2015 18:51, Domen Kožar wrote: > I've once experimented and ported nixpkgs manual > to http://static.domenkozar.com/nixpkgs-manual-sphinx-exp/ this is really impressive! ___ nix-dev mailing list nix-dev@lists.science.uu.nl

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

2015-11-19 Thread Colin Putney
On Wed, Nov 18, 2015 at 9:51 AM, Domen Kožar 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

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

2015-11-19 Thread Domen Kožar
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

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

2015-11-18 Thread Matthias Beyer
I created a showcase on how to generate documentation from the nixpkgs tree: https://github.com/matthiasbeyer/nixpkgs/tree/pandoc-documentation Note: 1) The documentation is still generated from .md files, not by parsing .nix files. This could be changed, but isn't trivial.

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

2015-11-18 Thread Domen Kožar
I've once experimented and ported nixpkgs manual to http://static.domenkozar.com/nixpkgs-manual-sphinx-exp/ But there doesn't seem to be of a much interest to make documentation more approachable (something we did with github for code) On Wed, Nov 18, 2015 at 6:47 PM, Matthias Beyer