Nix-docgen: automatic documentation generation to a Github Pages endpoint

Announcements
1

Looking for a generated nixpkgs documentation I’ve found some problems.

  • Which branch is the documentation being generated?
  • Theme issues
  • Hard-to-findness
  • Customization: what if I want to see my PR documentation live?
  • Freshness: how old is the documentation I am looking now

Yeah, we already have some solutions for these but I find out doing mine would be much more customizable and fun so I did this [1]. It’s a bash static site generator that uses Nix to build documentation and organize it to be used as a GH Pages site. Pretty simple, pretty automatic, just the main page CSS is not so pretty but surely does the job. The site is hosted on [2].

Currently the site is rebuilt daily and I started it today ¯_(ツ)_/¯

[1] GitHub - lucasew/nix-docgen: Generate documentation of different nixpkgs branches and upload to github actions
[2] Available built documentation

2 Likes
2

I’ve transfered the repo and gh pages site to the NixOS Brasil org, so the links now are
[1] GitHub - nixosbrasil/nix-docgen: Generate documentation of different nixpkgs branches and upload to github actions
[2] Available built documentation