[doc-only] cuda.{core,bindings,pathfinder}: nightly install docs and unify "Development environment" structure#2187
Open
leofang wants to merge 2 commits into
Open
[doc-only] cuda.{core,bindings,pathfinder}: nightly install docs and unify "Development environment" structure#2187leofang wants to merge 2 commits into
leofang wants to merge 2 commits into
Conversation
…y (top-of-tree) builds Extends the cuda.core change in NVIDIA#2175 to the remaining cuda-python components named in NVIDIA#2166 (which also covers cuda.bindings and cuda.pathfinder). cuda_bindings: - Add a new "Development environment" section to install.rst with a "Installing the latest nightly (top-of-tree builds)" subsection, matching the cuda.core layout. Artifact pattern includes the CUDA major (cuda13*) since cuda-bindings wheels are CUDA-versioned. cuda_pathfinder: - Add a new install.rst (PyPI / Conda / Development environment with nightly subsection / Source). cuda.pathfinder previously had no standalone install page. Nightly uses the single pure-Python cuda-pathfinder-wheel artifact (no python/platform/CUDA selection needed). - Wire install.rst into the toctree in index.rst.
Contributor
github-actions
Bot
added
cuda.bindings
…rce" under "Development environment" Make "Installing from Source" consistently a subsection of "Development environment" across all three components instead of a top-level sibling, matching the intent of the developer-workflow group introduced in NVIDIA#2175. - cuda.core: drop "Installing from Source" from --- to ~~~ (now under Development environment, as a sibling of nightly / uv / pixi). - cuda.bindings: drop "Installing from Source" from --- to ~~~, and drop its "Requirements" and "Editable Install" subsections from ~~~ to ^^^ accordingly. - cuda.pathfinder: drop "Installing from Source" from --- to ~~~ in the new install.rst added earlier in this branch. Also bump SPDX copyright headers on touched existing files to 2025-2026; the new cuda_pathfinder install.rst uses 2026.
leofang
changed the title
leofang
added
documentation
Member
Author
|
/ok to test c3e158c |
|
Member
Author
|
@rparolin this is ready |
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
1 participant
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.
What
Extends #2175 to the remaining components named in #2166 (which covers all three of cuda.pathfinder, cuda.bindings, and cuda.core — the original PR only added the nightly recipe for cuda.core), and unifies the install-doc structure across all three components.
Commit 1 — nightly recipes for the other two components
cuda_bindings/docs/source/install.rst: add a new Development environment section with an Installing the latest nightly (top-of-tree builds) subsection, between Installing from Conda and Installing from Source. Mirrors the cuda.core layout. The artifact pattern includes the CUDA major (cuda13*) because cuda-bindings wheels are CUDA-versioned.cuda_pathfinder/docs/source/install.rst(NEW): cuda.pathfinder previously had no install page. Adds a minimal install.rst (PyPI / Conda / Development environment → nightly / Source). Nightly uses the single pure-Pythoncuda-pathfinder-wheelartifact — no python/platform/CUDA selection needed.cuda_pathfinder/docs/source/index.rst: wireinstallinto the toctree.Commit 2 — consistent nesting of "Installing from Source"
---to~~~so it lives under Development environment as a sibling of the nightly / uv / pixi subsections (instead of as a top-level sibling of Development environment).~~~to^^^so the depth still works.2025-2026; the new cuda_pathfinderinstall.rstcarries2026.Why
#2166 asks for the top-of-tree install recipe to be documented in the developer guide for all components. #2175 only covered cuda.core; this PR closes the gap for the other two and additionally unifies the section nesting so the developer-workflow group reads consistently across all three install pages.
Tested
gh run list -R NVIDIA/cuda-python -w ci.yml -b main -s success -L1resolves cleanly against the live repo.sphinx-buildof all three docs sets (cuda_core/docs,cuda_bindings/docs,cuda_pathfinder/docs) succeeds with no new warnings on the changed/added install.rst files. Pre-existing autosummary warnings in cuda_pathfinder (the package isn't installed in the build env) are unchanged.ci/tools/env-vars(cuda-bindings-python{PY}-cuda{CUDA_VER}-{PLATFORM}-{SHA}) and the cuda.pathfinder upload step (cuda-pathfinder-wheel, single artifact per run).Notes