This repository was archived by the owner on May 20, 2026. It is now read-only.
feat: add build-docs check#15
Merged
Merged
Conversation
Signed-off-by: Pablo Garay <pagaray@nvidia.com>
Signed-off-by: Pablo Garay <pagaray@nvidia.com>
Signed-off-by: Pablo Garay <pagaray@nvidia.com>
Signed-off-by: Pablo Garay <pagaray@nvidia.com>
Signed-off-by: Pablo Garay <pagaray@nvidia.com>
chtruong814
approved these changes
Oct 28, 2025
pthombre
approved these changes
Oct 28, 2025
abhinavg4
approved these changes
Oct 28, 2025
abhinavg4
left a comment
Contributor
There was a problem hiding this comment.
Looks good. Although the conf.py still uses ../nemo_vfm, can you please point it to ../dfm ?
huvunvidia
pushed a commit
that referenced
this pull request
Feb 12, 2026
feat: add build-docs check
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
feat: add build-docs check
Updated Sphinx Configuration
File: C:\Users\palen\Code\DFM\docs\conf.py
Added three important configurations:
Suppress warnings for cross-references and autodoc issues
suppress_warnings = [
"myst.xref_missing", # Missing cross-references in included README
"autodoc2", # Autodoc2 warnings during API doc generation
]
This suppresses 85 warnings that were causing the build to fail, including the 4 cross-reference warnings for README links.
Github links can get rate limited from Github Actions
linkcheck_ignore = [
".github\.com.",
".githubusercontent\.com.",
]
This prevents linkcheck failures from GitHub rate limiting.
The warnings were legitimate (README links to files not in the Sphinx tree, and autodoc2 processing warnings), but should be safe to suppress for documentation builds.
Changes Made:
Added myst.header - Suppresses warnings about documents starting at H2 instead of H1. This is coming from autodoc2's auto-generated RST files, which is expected behavior.
Added toc.not_included - Suppresses the warning about apidocs/index.rst not being in the toctree. Since autodoc2 generates API docs that aren't explicitly added to the main table of contents, this is expected.
These warnings are all related to autodoc2's auto-generated documentation files and are safe to suppress