Repository navigation
docs(api): put APIs at menu root, clarify nesting (v6.2 backport of #4708) - #4712
Open
JorisHeadease wants to merge 1 commit into
Open
JorisHeadease wants to merge 1 commit into
JorisHeadease wants to merge 1 commit into
Conversation
Addresses the feedback on nuts-foundation/nuts-knooppunt#651. The deprecated APIs nest under a Deprecated tag through the OpenAPI 3.2 tag parent instead of x-tagGroups, so the other APIs sit at the menu root. Custom CSS gives nested objects and expanded responses a stronger line and a tint per level, and hides Scalar's breadcrumb bar, which shows an unrelated trail outside the deprecated APIs once a tag has a parent.
JorisHeadease
marked this pull request as ready for review
November 17, 2026 16:41
JorisHeadease
requested review from
gerardsn,
reinkrul,
stevenvegt and
woutslakhorst
as code owners
November 17, 2026 16:41
reinkrul
approved these changes
Nov 17, 2026
This branch has not been deployed
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.
Backport of #4708 to V6.2.
Same change as on master: the cherry-pick applies without conflicts, as V6.2's API reference files were identical to master's.
Verified on this branch: the merge script combines the specs into 85 operations, with the active APIs at the menu root and the deprecated ones under Deprecated, and links to tags and operations unchanged. The breadcrumb bar stays hidden, nested objects and expanded responses get the tint while collapsed panels don't, and Sphinx builds without warnings, as before.