The documentation is quite extensive, but I sometimes have troubles navigating it (on-line) and searching through it.
My suggestion is to make a readthedocs - style navigation menu (always visible) so it is clear in which section you are, and also makes navigation more easy
2 Likes
Perhaps even provide a “many-html” version rather the “single-html”.
That was attempted in https://github.com/NixOS/nixpkgs/pull/68020 but it got stuck on some performance issues.
You might be interested in Welcome to the NixOS documentation! — NixOS Manual documentation 
Details in this comment.
3 Likes