Hmm, this is a good start.

With regards to doc formatting, it is pretty scrappy, frankly. I think I am going to replace the whole thing with just encoding the TOML values directly using the underlying pelletier/go-toml dependency that koanf itself uses, and deciding to wrap it in a large code block if it's multiline, or in an inline one if it is one line. That way we don't introduce any actually new dependencies just for serialization for docs. You can refactor your PR to reflect after I finish that tonight probably.

I do have one concern though. I am not using any of the NixOS aliases, so there should be a way to disable this, since it may come across as surprising for some longtime users of this application, and clutter up alias descriptions. This can probably come in the form of another setting, UseNixOSRebuildAliases or something similar, set to true by default.

I added an option to disable it, but I think calling it use_default_aliases is better as we will add aliases that are not nixos-rebuild commands, e.g eval as part of #193.

I also had to format them a different way as the default for the aliases setting is now not changed.

I added an option to disable it, but I think calling it use_default_aliases is better as we will add aliases that are not nixos-rebuild commands

Agreed, I couldn't come up with a better name at the time LOL.

I've made a PR that normalizes the value serialization stuff; that might make your work on this much easier and you can probably remove most of the manual refactoring for formatting values in the docgen.

I've made a PR that normalizes the value serialization stuff; that might make your work on this much easier and you can probably remove most of the manual refactoring for formatting values in the docgen.

I had to resort to displaying the defaults in the description for use_default_aliases using a custom formatting function. I would add the default to Aliases instead, but I don't know how to make it conditional on use_default_aliases.