Design a useful sidebar
Help readers find their next step.
Organize navigation around the tasks readers want to complete. A new reader should find setup quickly, while a returning reader should reach a specific reference page without opening every section.
Start with reader needs
Put a quickstart and prerequisites near the beginning. Group recurring tasks into guides and keep detailed fields or syntax in reference pages. Use a small number of meaningful sections instead of a flat list of every page.
Apply the structure
Ask the agent to propose a navigation plan before moving files. Current projects use meta.json for ordering and section titles. Add section landing pages when they can explain the topic and point readers to the right task.
Keep existing file paths where possible when reorganizing a published site. Changing display order is less disruptive than moving all the files.
Review the result
Try three tasks: find the first setup step, find a specific configuration option and recover from a common error. Repeat on mobile. If you need to know your internal project structure to find an answer, simplify the labels.