Multi-View Docs

1

Hey everyone

I want to start off by commending the nix community. Even tho this is a complex system and with the declarative approach also adding complexity and divergence in how things are done compared to other Linux distros, it is still well maintained and really well documented.

It is with the documentation that I have a bit of a problem. The way I’ve been working so far (and maybe this is the problem), I looked at the documentation of whatever I wanted to work on - fontconfig, wayland, wezterm on their official website. Once I knew the config options I wanted to change, I hopped on to nix where I read the Appendix A for NixOS and HomeManager to find the match for the config option I wanted to change.

And don’t get me wrong, the Appendix A is amazing. But I’d appreciate a tree view, where I can expand deeper and deeper into the thing I want to look at. And I’d also greatly appreciate it, if the explanation of a given config option was also collapsible. That way I don’t need to have many tabs open with the options I need and want to refer back to. I can attempt to fist most of what I need into a single window.

Is this something that could possibly be added? Or does it exist already and I just didn’t find it yet.

Best

AS2k

2

Perhaps this one?
https://search.nixos.org/options?channel=25.11&query=fontconfig

3 Likes
3

Yes and no.

It’s very much on the right track, the expanding and collapsing is what I’m looking for.
But it still is not hierarchical.

I cannot for example:

  • Unfold boot.loader to get to timeout and canTouchEfiVariables
  • Then have generic, efi, external not unfolded,
  • and then boot.loader.grub unfolded again.

Thanks for pointing it out tho. I will refer to this search for the moment.

AS2k