Skip to content

[codex] Fix generated cuda-bindings problematic doc anchors#2186

Open
kkraus14 wants to merge 25 commits into
mainfrom
codex/fix-cuda-bindings-problematic-doc-anchors
Open

[codex] Fix generated cuda-bindings problematic doc anchors#2186
kkraus14 wants to merge 25 commits into
mainfrom
codex/fix-cuda-bindings-problematic-doc-anchors

Conversation

@kkraus14

@kkraus14 kkraus14 commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator

Description

Stacked on #2159. This removes the temporary lychee exclusion for generated
cuda-bindings #id[0-9]+ anchors after regenerating the affected CUDA Driver
and Runtime docs/docstrings from the targeted cybind fix.

Cybind dependency: https://gitlab-master.nvidia.com/leof/cybind/-/merge_requests/410

Changes

  • Regenerate the targeted cuda-bindings Driver/Runtime RST and Cython docstring
    output that previously rendered docutils problematic anchors.
  • Remove the temporary rendered-docs lychee exclusion for
    cuda-bindings/latest/module/{driver,runtime}.html#id[0-9]+ from
    build-docs.yml.

Validation

  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run check-yaml --files .github/workflows/build-docs.yml
  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run actionlint --files .github/workflows/build-docs.yml
  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run lychee --files cuda_bindings/docs/source/module/driver.rst cuda_bindings/docs/source/module/runtime.rst
  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run rst-backticks --files cuda_bindings/docs/source/module/driver.rst cuda_bindings/docs/source/module/runtime.rst
  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run rst-directive-colons --files cuda_bindings/docs/source/module/driver.rst cuda_bindings/docs/source/module/runtime.rst
  • PRE_COMMIT_HOME=/tmp/pre-commit-cache-2159 pixi run pre-commit run rst-inline-touching-normal --files cuda_bindings/docs/source/module/driver.rst cuda_bindings/docs/source/module/runtime.rst
  • pixi run --manifest-path cuda_bindings -e docs build-docs

Local rendered-HTML lychee still fails when building docs against the installed
13.2.0 cuda-bindings package because those generated docstrings are stale in the
local docs environment. The full local package build was blocked by unrelated
cufile symbol mismatches in the local CUDA package set, so CI should validate
the rendered HTML with the PR-built package.

@kkraus14 kkraus14 added this to the cuda.bindings next milestone Jun 9, 2026
@kkraus14 kkraus14 added documentation Improvements or additions to documentation CI/CD CI/CD infrastructure cuda.bindings Everything related to the cuda.bindings module labels Jun 9, 2026
@kkraus14

kkraus14 commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@kkraus14 kkraus14 self-assigned this Jun 9, 2026
@kkraus14 kkraus14 force-pushed the codex/fix-cuda-bindings-problematic-doc-anchors branch from 127f9f6 to 159377e Compare June 9, 2026 17:41
@kkraus14

kkraus14 commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@kkraus14

kkraus14 commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@kkraus14

kkraus14 commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator Author

/ok to test

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown

Base automatically changed from codex/docs-stable-source-linkcheck to main June 9, 2026 20:53
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 documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant