docs: declare sidebar group order in section frontmatter - #8069
Merged
Conversation
The docs sidebar groups sections under a `navGroup` heading, but the order of those groups was a hardcoded array in the website repo, so reordering, renaming or adding a group meant a website change even though the group names themselves are declared here. Add `navGroupOrder` alongside each `navGroup`. The website derives a group's position from the lowest `navGroupOrder` of its sections, so the whole docs structure (paths, page order, group names, group order) now lives with the docs. Values match the order the website rendered before this change.
5 tasks
Contributor
Author
|
@hardillb this is about moving logic of how the navigation is defined from the website to the documentation so there is an SSOT. With the docs to nuxt migration this got tangled up, and currently part of the nav is hardcoded in https://github.com/FlowFuse/website. After this PR merges, we can merge FlowFuse/website#5513 |
hardillb
approved these changes
Aug 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The docs sidebar groups sections under a
navGroupheading, but the order of those headings is a hardcoded array in the website repo (GROUP_ORDERinnuxt/composables/useDocsNav.ts), even though the group names themselves are declared here. Adding, renaming or reordering a group needed a website change.This adds
navGroupOrderalongside eachnavGroup. The website ranks a heading by the lowestnavGroupOrderof its sections, so the whole docs structure (paths, page order, group names, group order) now lives in this repo.Values reproduce the order the site renders today. Merge this before the website side, which drops the array: FlowFuse/website#5513