demo idea: restructure docs into section-based sidebars#261
demo idea: restructure docs into section-based sidebars#261
Conversation
|
I am a big fan of this! |
|
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. |
|
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. |
|
@heskew That's interesting. Did you build and run it? Or just ran it without building? |
|
@Ethan-Arrowood sidebar(s) can be expanded by default iirc @ldt1996 I don't recall. :) I'll give it another clean try shortly |
|
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 |
|
FYI we are going to be incorporating these ideas into some future doc reorganization changes. Thank you! |
3 participants
Changed the docs navigation so that each section has its own sidebar instead of everything being in one big list.
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.