I converted nix-pills from docbook XML into mdbook. What do you think?

Hi,

I find it significantly easier to read mdbook sites, such as the Nix Reference Manual, over the current form of nix-pills. I also think that having the docs as markdown makes it much easier for others to contribute.

So I decided to try and convert nix-pills into mdbook. The rendered HTML can be viewed here.

Most of the work was done by pandoc, and I added manual tweaks and fixes.

The PR is here.

What do you think?

Thanks,
Noam

13 Likes

Nice! We’ll briefly discuss it in the docs team. I think this should just be merged.

2 Likes