Merge branch 'main' into pyi-experiment

mdboom · web-flow · commit dacb4d28d3ba · 2026-06-08T17:50:09.000-04:00
diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
@@ -47,7 +47,7 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
           ref: ${{ inputs.git-tag }}
 
       - name: Read build CTK version
diff --git a/.github/workflows/build-wheel.yml b/.github/workflows/build-wheel.yml
@@ -42,7 +42,10 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: setuptools-scm needs the commit graph (`git describe`)
+          # but not historical blobs.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Install latest rapidsai/sccache
         if: ${{ startsWith(inputs.host-platform, 'linux') }}
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -35,7 +35,7 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
       - name: Get CUDA build versions
         id: get-vars
         run: |
@@ -106,7 +106,10 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: commit graph is needed for `git merge-base` and
+          # `git diff --name-only` below, but historical blobs aren't.
           fetch-depth: 0
+          filter: blob:none
 
       # copy-pr-bot pushes every PR (whether it targets main or a backport
       # branch such as 12.9.x) to pull-request/<N>, so the base branch
diff --git a/.github/workflows/cleanup-pr-previews.yml b/.github/workflows/cleanup-pr-previews.yml
@@ -30,8 +30,10 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v6.0.3
         with:
-          # Fetch all history and branches for worktree operations
+          # Treeless clone: `git worktree add gh-pages` needs the commit graph,
+          # but historical blobs aren't required.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Configure git identity
         run: |
diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yml
@@ -66,7 +66,10 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: setuptools-scm needs the commit graph (`git describe`)
+          # but not historical blobs.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Fix workspace ownership
         run: |
@@ -198,7 +201,10 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: setuptools-scm needs the commit graph (`git describe`)
+          # but not historical blobs.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
@@ -269,7 +275,7 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
 
       - name: Setup proxy cache
         uses: nv-gha-runners/setup-proxy-cache@main
diff --git a/.github/workflows/release-cuda-pathfinder.yml b/.github/workflows/release-cuda-pathfinder.yml
@@ -61,7 +61,9 @@ jobs:
 
       - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          # lookup-run-id resolves the git tag to a SHA; we need tags but not history.
+          fetch-depth: 1
+          fetch-tags: true
           # Resolve only the exact tag ref; checkout fails if the tag does not exist.
           ref: refs/tags/${{ steps.vars.outputs.tag }}
 
@@ -161,7 +163,7 @@ jobs:
     steps:
       - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
           ref: ${{ needs.prepare.outputs.tag }}
 
       - name: Create source archive
diff --git a/.github/workflows/release-upload.yml b/.github/workflows/release-upload.yml
@@ -43,7 +43,7 @@ jobs:
       - name: Checkout Source
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
           ref: ${{ inputs.git-tag }}
 
       - name: Create Release Directory
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -43,8 +43,9 @@ jobs:
       - name: Checkout Source
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          # fetch-depth: 0 is required so the lookup-run-id script can access all git tags
-          fetch-depth: 0
+          # lookup-run-id resolves the git tag to a SHA; we need tags but not history.
+          fetch-depth: 1
+          fetch-tags: true
 
       - name: Determine Run ID
         id: lookup-run-id
@@ -62,7 +63,7 @@ jobs:
       - name: Checkout Source
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
-          fetch-depth: 0
+          fetch-depth: 1
 
       - name: Check or create draft release for the tag
         env:
diff --git a/.github/workflows/test-sdist-linux.yml b/.github/workflows/test-sdist-linux.yml
@@ -28,7 +28,10 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: setuptools-scm (invoked via `python -m build`) needs
+          # the commit graph (`git describe`) but not historical blobs.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
diff --git a/.github/workflows/test-sdist-windows.yml b/.github/workflows/test-sdist-windows.yml
@@ -34,7 +34,10 @@ jobs:
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
+          # Treeless clone: setuptools-scm (invoked via `python -m build`) needs
+          # the commit graph (`git describe`) but not historical blobs.
           fetch-depth: 0
+          filter: blob:none
 
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -9,7 +9,8 @@ Thank you for your interest in contributing to CUDA Python! Based on the type of
     them for a release. If you believe the issue needs priority attention
     comment on the issue to notify the team.
 2. You want to implement a feature, improvement, or bug fix:
-    - Please refer to each component's guideline:
+   - Before starting work on an existing issue, please comment on the issue to express your interest and wait to be assigned by a maintainer. This helps avoid redundant effort in case the issue is already being worked on by another contributor or an NVIDIA team member.
+   - Please refer to each component's guideline:
        - [`cuda.core`](https://nvidia.github.io/cuda-python/cuda-core/latest/contribute.html)
        - [`cuda.bindings`](https://nvidia.github.io/cuda-python/cuda-bindings/latest/contribute.html)<sup>[1](#footnote1)</sup>
        - [`cuda.pathfinder`](https://nvidia.github.io/cuda-python/cuda-pathfinder/latest/contribute.html)
diff --git a/cuda_core/docs/source/contribute.rst b/cuda_core/docs/source/contribute.rst
@@ -18,4 +18,5 @@ Thank you for your interest in contributing to ``cuda-core``! Based on the type
 
 2. You want to implement a feature, improvement, or bug fix:
 
+   - Before starting work on an existing issue, please comment on the issue to express your interest and wait to be assigned by a maintainer. This helps avoid redundant effort in case the issue is already being worked on by another contributor or an NVIDIA team member.
    - Please ensure that your commits are signed `following GitHub's instruction <https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification>`_.
diff --git a/cuda_pathfinder/docs/source/contribute.rst b/cuda_pathfinder/docs/source/contribute.rst
@@ -14,4 +14,5 @@ Thank you for your interest in contributing to ``cuda-pathfinder``! Based on the
       them for a release. If you believe the issue needs priority attention
       comment on the issue to notify the team.
 2. You want to implement a feature, improvement, or bug fix
+    - Before starting work on an existing issue, please comment on the issue to express your interest and wait to be assigned by a maintainer. This helps avoid redundant effort in case the issue is already being worked on by another contributor or an NVIDIA team member.
     - Please ensure that your commits are signed `following GitHub's instruction <https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification>`_.
