release/6.0: Unify docs build into a single build, support proper multiversion links #93
Conversation
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
* Enforce PR description in CI * Add pull_request edit event * Move to its own file so checks don't run for every edit * formatting * add reopened event
* Update Isaac Sim Workflow * Add Isaac Lab Multi GPU/Node Samples
* Use sphinx-multiversion so multiple versions of the docs are built --------- Co-authored-by: Fernando Luo <[email protected]>
* docs: fix broken user_guide multiversion links * Revert img src change Co-authored-by: RyaliNvidia <[email protected]> --------- Co-authored-by: RyaliNvidia <[email protected]>
apk add may fail due to things like transient upstream unavailability. Prior to this change we would get stuck in an infinite loop of trying to invoke curl. This change makes the simplest change to make it fail and let K8s handle restarting the init container.
* Make docs root page use a grid * remove main branch specifier
* Add ci-docs step to run bazel tests on docs/ changes * only run build - not test
* Add link checking to documentation * Verified check * Fix artifacts upload * Resolve issue * update workflows logic
* Unify Sphinx build to build as one project instead of separate User Guide and Deployment Guide builds * Change hard-coded URLs to use Sphinx roles so the correct multiversion link can be interpolated at build time The goal of this change is to make the links in our docs version-aware after moving to multiversion docs in #40. Normally the way to do this is to reference roles like `:doc:` and `:ref:` instead of hard-coding URLs, but since we have cross-guide links we also have to unify the Sphinx build to make the builds aware of roles across all our docs.
RyaliNvidia
approved these changes
Nov 26, 2025
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.
Description
Port of #81 for
release/6.0. Refer to #81 for details of this change.mainIssue #92
Checklist