I have inherited a Hugo docs site which has got into a bit of a mess over time.
I’m not an advanced web dev and I don’t know Go. However, I am technically minded and can follow technical docs fairly well.
The docs I’m working on have a linear menu, so every page referenced on the left menu bar refers to one single index.md. Some of these index.md pages are in the 1000s of lines long now as devs continually append content to a single page.
I figured it would be a simple thing to start restructuring and splitting out these pages into a nested menu configuration. However, after an afternoon of playing with Hugo, I have really no idea where to begin.
Your content subfolders have both index.md and _index.md. This is probably causing issues somewhere as both content/foo/bar/_index.md and content/foo/bar/index.md will probably try to render at yoursite.com/foo/bar/. But which page is actually there? Have a read here and here.
Note that creating a menu entry does not create a page, so if it 404s, it’s probably because the page itself is missing.
Depending on which one you keep, ie faq/_index.md vs faq/index.md, faq/general/ may or may not be created. See above docs linked.