demo idea: restructure docs into section-based sidebars

[ldt1996]

Changed the docs navigation so that each section has its own sidebar instead of everything being in one big list.

• added separate sidebars for:
  • getting started
  • developers
  • administration
  • deployments
  • technical details
• updated config so navbar items load the right sidebar for each section

Now when you click a top-level section, the sidebar only shows that section’s content.

Please note I didn't update the sidebar for any other version than 4.6. This is just a demo.

[Ethan-Arrowood]

I am a big fan of this!

[heskew]

love the direction. didn't work for me on the home page and when it does show I didn't see sub items but I realize this is a poc/demo. currently is pretty annoying to have sections expanded here and there in the sidebar. would much rather keep it tidy, like what seems to be the intent here.

[Ethan-Arrowood]

Yeah I didn't even test locally yet, but by the screenshot I see what the goal is and I really like it. Helps a bit with the organization of everything. Navigating the multiple nested sections can be hard. I think on gitbook they were expanded by default so it wasn't as bad, but now you've got extra clicks to get to the right page.

[ldt1996]

@heskew That's interesting. Did you build and run it? Or just ran it without building?

[heskew]

@Ethan-Arrowood sidebar(s) can be expanded by default iirc

@ldt1996 I don't recall. :) I'll give it another clean try shortly

[heskew]

just tried this out with the build artifact. still have the homepage problem. guessing it's not in a sidebar so there's no sidebar shown. might make sense to put the homepage in the getting started sidebar and removing the getting started index.

I do like this direction. we'd have to work on the ux since the top nav gets too crammed before we flip to the nave menu. we'll also have release notes up there...