nixos manuals are way too big and hard to navigate

[jnoortheen]

Describe the bug
As of now the manual pages are big and takes too long to load. Also it is hard to navigate between titles.
The initial page load take too long https://nixos.org/nixos/manual/index.html . If I hit any of the title's that too makes the page load again https://nixos.org/nixos/manual/index.html#sec-writing-documentation .

It is just a small usability thing. But it makes look like that nixOS coming from last era.

Can we adopt something like this ? on most of the doc frameworks, this is just a config change. But I haven't used docbook and want to help in anyway I can.

[jnoortheen]

Here are two theme which I think would be helpful if it is to use hugo as the docs generator

https://example.docsy.dev/docs/tasks/beds/
https://themes.gohugo.io//theme/hugo-book/

[jtojnar]

This is a known issue and it is being worked on, see NixOS/rfcs#64 and #68020

[jnoortheen]

Oh I see. It is sad that there doesn't seems to be any decision made yet. The RFCs are rejected.

[jtojnar]

We (the RFC shepherds) have decided to focus on a more focused RFC (currently being prepared) instead.

[jnoortheen]

OK. I am closing this.