docs request: linking directly to the modules

[aos]

Hey y'all - thanks for putting this together. It's been great having a good reference for proper defaults. While I was browsing the docs, I saw that there are references to the code, like so:

Unfortunately, this means that I also need to have a separate tab open to find this particular file and look through it. I see with mkdocs you have a variable for the repo_url. I attempted to template that in, but it seems like your version of mkdocs doesn't support this feature of Jinja templating, eg. {{ repo_url }}/blob/main/nixos/hardware/hetzner-cloud/default.nix. There are plugins for this (like this one), but I don't know your appetite for going that far. :-)

What are your thoughts on just adding hardcoded links directly to modules in the Github repo? So the above: nixosModules.hardware-hetzner-cloud becomes: nixosModules.hardware-hetzner-cloud? I'm happy to put together a PR for it if so.

[zimbatm]

Hey aos, thanks for caring about the details, this is going to make future users experience much nicer.

I'm up for enabling the plugin. We actually have it already in the environment, it just wasn't added to the mkdocs plugin list (see numtide/mkdocs-numtide). You could enable it upstream or here.

[aos]

Hi @zimbatm - looks like you did the hard work already. Thanks :-) I went ahead and sent the change upstream: numtide/mkdocs-numtide#5

Once that's merged in, I can make a PR here to pull in the new input hash and make the change here.

[zowoq]

I can make a PR here to pull in the new input hash and make the change here.

The docs also seem to be broken in yesterdays flake update by other changes from mkdocs-numtide: #475.

[zimbatm]

thanks @aos, merged!

@zowoq fixed in #478