Skip to content

fix: sidebar sorting - #283

Merged
rich-iannone merged 10 commits into
mainfrom
fix-sidebar-sorting
Jul 24, 2026
Merged

fix: sidebar sorting#283
rich-iannone merged 10 commits into
mainfrom
fix-sidebar-sorting

Conversation

@rich-iannone

@rich-iannone rich-iannone commented Jul 24, 2026

Copy link
Copy Markdown
Member

This PR improves the handling and documentation of user guides that mix root-level files and subdirectory sections, ensuring sidebar navigation interleaves them according to numeric prefixes (rather than grouping all files before all sections). It also adds tests and some documentation (in the 08-user-guides.qmd page) to explain this behavior.

In the new GDG site (to test this functionality) we have this directory/file structure for the user guide:

image

and it results in this sidebar structure:

image

Note that the subdirectory index.qmd files contain the full titles for the sidebar sections in the YAML frontmatter title: lines.

Fixes: #282

@rich-iannone
rich-iannone merged commit 1942d76 into main Jul 24, 2026
8 checks passed
@rich-iannone
rich-iannone deleted the fix-sidebar-sorting branch July 24, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

user-guide sorting

1 participant