DOCOPS-176 Add page-tabs attributes to driver component descriptors - #524
Merged
Conversation
Set page-tabs, page-tabs-index and page-tabs-group in each driver manual's antora.yml rather than in the publish playbook. The playbook carries a single value for the whole build, which cannot order the five driver manuals within the drivers-apis tab. Indexes are spaced 10, 12, 14, 16, 18 in the existing order (Python, Go, Java, JavaScript, .NET), leaving gaps for further drivers. page-tabs-group groups all driver manuals so every published version is emitted and the UI can match the tab nav by version. page-tabs is soft-set with a trailing @ so it can be overridden on a page. Same change as on dev, applied to this published branch.
Bring in the v2 docs workflows so this PR gets PR checks.
Collaborator
|
Thanks for the documentation updates. The preview documentation has now been torn down - reopening this PR will republish it. |
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.
Adds
page-tabs,page-tabs-indexandpage-tabs-groupto each driver manual'santora.yml:Places the driver manuals in the
drivers-apistab of the aggregated tabbednavigation. Indexes are spaced 10, 12, 14, 16, 18 in the existing order (Python, Go,
Java, JavaScript, .NET), leaving gaps for further drivers.
These are set per component rather than in the publish playbook: a playbook carries a
single value for the whole build, which cannot order the five manuals within the tab.
page-tabs-groupgroups the driver manuals so that every published version is emittedin the tab navigation and the UI can match it by version, rather than only the latest
version being included. This is why the same change is needed on each published
branch.
Same change as on
dev, applied to this published branch.page-tabsis soft-set with a trailing@so it can be overridden.