ldoc
ldoc copied to clipboard
Jumping of "Modules", "Contents" sections in side bar is very confusing to newcomers
The "Contents" section changes in size: on the Index site it isn't even visible at all, then suddenly pops in on the module sub sites when navigating around, pushing "Modules" down.
This is very confusing when not familiar with the LDoc layout, because on first sight the "Modules" section appears to be completely replaced with something radically different until the user discovers it just suddenly moved down a lot.
Therefore:
- The "Index" link should always be visible, even on the "Index" site itself. This avoids jumping of everything below when it becomes visible, or disappears depending on where the user navigates.
- The "Contents" section should appear either below the "Modules" section (the "Modules" section could be collapsible by the user with some JavaScript collapse button), or it should have a fixed height with vertical scrollbar with its space also being reserved as blank space even when the "Contents" section isn't visible on the index. Alternatively, add a right sidebar or something for "Contents" to get it to a completely different, separate place.
If others are a fan of the current layout, I would recommend providing an easy option to switch and consider a sensible default (e.g. possibly NOT what is the current behavior, since while it is quite unproblematic for familiar users it is very jarring to newcomers to LDoc documentations).