document known upgrade issues

Author: leofang

cuda_bindings/docs/source/release.rst

@@ -6,6 +6,7 @@ Release Notes
 .. toctree::
    :maxdepth: 3
 
+   12.X.Y <release/12.X.Y-notes.rst>
    12.9.0 <release/12.9.0-notes.rst>
    12.8.0 <release/12.8.0-notes.md>
    12.6.2 <release/12.6.2-notes.md>

cuda_bindings/docs/source/release/12.8.0-notes.md

@@ -29,3 +29,8 @@ Same applies to `cuda-bindings`.
 ## Discovery and loading of shared library dependencies from wheels
 
 Shared library search paths for wheel builds are now extended to check site-packages. This allows `cuda-python`/`cuda-bindings` to seamlessly use the aforementioned CUDA Toolkit wheels installed in the user's Python environment.
+
+
+## Known issues
+
+- Updating from older versions (v12.6.2.post1 and below) via `pip install -U cuda-python` might not work. Please do a clean re-installation by uninstalling `pip uninstall -y cuda-python` followed by installing `pip install cuda-python`.

cuda_bindings/docs/source/release/12.9.0-notes.rst

@@ -33,3 +33,9 @@ Miscellaneous
 * Improvements in the introductory code samples
 * Fix performance hint warnings raised by Cython 3
 * Improvements in the Overview page
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.

cuda_bindings/docs/source/release/12.X.Y-notes.rst

@@ -0,0 +1,24 @@
+.. SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
+
+``cuda-bindings`` 12.X.Y Release notes
+======================================
+
+Released on MM DD, 2025
+
+
+Highlights
+----------
+
+
+Bug fixes
+---------
+
+
+Miscellaneous
+-------------
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.

cuda_python/docs/source/release.md

@@ -5,6 +5,7 @@
 maxdepth: 3
 ---
 
+    12.X.Y <release/12.X.Y-notes>
     12.9.0 <release/12.9.0-notes>
     12.8.0 <release/12.8.0-notes>
     12.6.2 <release/12.6.2-notes>

cuda_python/docs/source/release/12.8.0-notes.md

@@ -14,3 +14,8 @@ Released on January 24, 2025.
 - Add optional dependencies on CUDA NVRTC and nvJitLink wheels
 - Enable discovery and loading of shared libraries from CUDA wheels
 - `cuda-python` is now a meta package, currently depending only on `cuda-bindings` ([see RFC](https://github.com/NVIDIA/cuda-python/issues/105))
+
+
+## Known issues
+
+- Updating from older versions (v12.6.2.post1 and below) via `pip install -U cuda-python` might not work. Please do a clean re-installation by uninstalling `pip uninstall -y cuda-python` followed by installing `pip install cuda-python`.

cuda_python/docs/source/release/12.9.0-notes.rst

@@ -16,3 +16,9 @@ Highlights
 ----------
 
 * Add bindings for libNVVM
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.

cuda_python/docs/source/release/12.X.Y-notes.rst

@@ -0,0 +1,20 @@
+.. SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
+
+CUDA Python 12.X.Y Release notes
+================================
+
+Released on MM DD, 2025.
+
+
+Included components
+-------------------
+
+
+Highlights
+----------
+
+
+Known issues
+------------
+
+* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.