fix(sidebar): main sidebar adjustments - #2383
Merged
marcus-souza-azion merged 2 commits intoSep 21, 2026
Merged
Conversation
marcus-souza-azion
merged commit Sep 21, 2026
e86a1e0
into
release/new-azion-docs
6 of 8 checks passed
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
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.
What & why
The docs home sidebar was a flat list of 34 rows where every row was a one-way trip into another sidebar. Two of those bands now open in place instead. Fundamentals becomes a dropdown whose pages keep the home sidebar rather than swapping to a sidebar of their own, and Platform stops being a group label over nine product rows and becomes a single dropdown holding How Azion works — the platform explainer, moved here from Fundamentals where it sat oddly — and Core services, a nested dropdown with the nine products. The collapsed home sidebar drops from 34 rows to 26, and the reader gets one obvious place to learn what the platform is. Build, Store, Secure, Observe and Manage keep their current shape.
Both are the same mechanism: a nav tree marked
"inline": truerenders inside the root sidebar instead of owning one, so its rows expand in place, its pages render the home sidebar with the active row highlighted, and none of its rows show the›that means "this replaces the sidebar". The tree files still exist, so breadcrumbs, prev/next and every navcheck contract keep working untouched — no changes tolint-navcheck.tsand noexempt.jsonentries. The second commit adds the label the open section was missing: a section's own menu now names itself above its first rows, in the design system's group-title treatment, on the rail, in the mobile drawer and in a menu opened from a chevron.Pages affected:
/documentation/platform/·/documentacao/plataforma/— the explainer, moved here and retitled "How Azion works" / "Como a Azion funciona"/documentation/fundamentals/·/documentacao/fundamentos/— new landing pages taking over those URLsuse-a-template.mdx,start-with-a-template.mdx,edge-application.mdx,overview.mdx(Runtime),usar-um-template-via-rtm.mdx,comecar-com-um-template.mdx,visao-geral-runtime.mdx, plussrc/data/agent-setup.jsonandsrc/i18n/en/footer.tssrc/nav/resolve.ts,schema.ts,root.json,trees/fundamentals.json,trees/platform.json(new)Type of change
feat) — the two Fundamentals landing pages, en + pt-brfix) — typo, broken link, wrong informationdocs) — rewrite, expansion, upkeep — the explainer retitled and movedi18n)refactor/chore)Author checklist
type(scope): summary(see GOVERNANCE.md §4)title,description,meta_tags,namespace,permalink,last_reviewed— all four pages carry the first five;last_reviewedis on zero pages corpus-widept-brupdated in this PR or follow-upi18nissue created:pnpm build:local(build + frontmatter check) without errors