document known upgrade issues

Author: leofang

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_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``.