Skip to content

[codex] Check versioned docs example links#2159

Draft
kkraus14 wants to merge 9 commits into
mainfrom
codex/docs-stable-source-linkcheck
Draft

[codex] Check versioned docs example links#2159
kkraus14 wants to merge 9 commits into
mainfrom
codex/docs-stable-source-linkcheck

Conversation

@kkraus14
Copy link
Copy Markdown
Collaborator

@kkraus14 kkraus14 commented Jun 1, 2026

What changed

  • Export CUDA_PYTHON_DOCS_GITHUB_REF in the docs workflow so docs builds can link examples to the release tag for release docs and the exact build commit for preview/latest docs.
  • Teach the cuda.core and cuda.bindings docs configs to prefer that workflow-provided ref before falling back to the existing local-build behavior.
  • Add opt-in Sphinx linkcheck runs to the cuda.core and cuda.bindings docs build scripts, enabled from the docs workflow, with linkcheck output written outside the deployed HTML tree.

Why

This complements #2156 by making example source links stable for built docs and by letting CI fail when rendered docs contain broken external links.

Validation

  • git diff --check origin/main...HEAD
  • bash -n cuda_core/docs/build_docs.sh
  • bash -n cuda_bindings/docs/build_docs.sh
  • Imported both docs configs with CUDA_PYTHON_DOCS_GITHUB_REF set and verified GITHUB_EXAMPLES_REF uses the provided ref.
  • Verified make -n linkcheck sends output to build/linkcheck/<version> for both docs packages.

Full docs/linkcheck was left to CI; local pixi validation started compiling the packages rather than just checking the docs configuration.

@copy-pr-bot
Copy link
Copy Markdown
Contributor

copy-pr-bot Bot commented Jun 1, 2026

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@github-actions github-actions Bot added CI/CD CI/CD infrastructure cuda.bindings Everything related to the cuda.bindings module cuda.core Everything related to the cuda.core module labels Jun 1, 2026
@kkraus14 kkraus14 added the documentation Improvements or additions to documentation label Jun 1, 2026 — with ChatGPT Codex Connector
@kkraus14 kkraus14 added this to the cuda.bindings next milestone Jun 1, 2026
@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 1, 2026

/ok to test

@github-actions github-actions Bot added the cuda.pathfinder Everything related to the cuda.pathfinder module label Jun 1, 2026
@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 1, 2026

/ok to test

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 1, 2026

@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

Comment thread cuda_bindings/docs/source/conf.py Outdated

def rewrite_source(app, docname, source):
text = source[0]
text = text.replace("|cuda_bindings_github_ref|", GITHUB_EXAMPLES_REF)
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

* Fixed an issue where the ``CU_POINTER_ATTRIBUTE_DEVICE_ORDINAL`` attribute was
retrieved as an unsigned int, rather than a signed int.
(`PR #1336 <https://github.com/NVIDIA/cuda-python/pull/1336>`_)
(`PR #1336 <https://github.com/NVIDIA/cuda-python/issues/1336>`_)
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the incorrect link, we should fix it


* Add missing driver & runtime bindings for functions new in CTK 13.1.0
(`PR #1321 <https://github.com/NVIDIA/cuda-python/pull/1321>`_)
(`PR #1321 <https://github.com/NVIDIA/cuda-python/issues/1321>`_)
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be 1337 which is the pull request addressing this issue

* Fixed an issue where the ``CU_POINTER_ATTRIBUTE_DEVICE_ORDINAL`` attribute was
retrieved as an unsigned int, rather than a signed int.
(`PR #1336 <https://github.com/NVIDIA/cuda-python/pull/1336>`_)
(`PR #1336 <https://github.com/NVIDIA/cuda-python/issues/1336>`_)
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be #1451

Comment thread .pre-commit-config.yaml
@kkraus14
Copy link
Copy Markdown
Collaborator Author

kkraus14 commented Jun 2, 2026

/ok to test

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI/CD CI/CD infrastructure cuda.bindings Everything related to the cuda.bindings module cuda.core Everything related to the cuda.core module cuda.pathfinder Everything related to the cuda.pathfinder module documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant