document version requirements for bindings v.s. numba-cuda

Author: isVoid

docs/source/faq.rst

@@ -122,3 +122,48 @@ Notes
   libc++, ensure its headers are installed (e.g., ``/usr/include/c++/v1`` or Conda ``libcxx-devel``) and pass
   ``-stdlib=libc++``; otherwise libstdc++ is typically selected by default on Linux.
 - AST Canopy is linked against Clang 20. For host resources, please use corresponding Clang version.
+
+
+Generated bindings and Numba-CUDA version requirements
+-------------------------------------------------------
+
+**What version of numba-cuda do generated bindings require?**
+
+Bindings generated by Numbast have specific version requirements for ``numba-cuda`` at runtime. The version of
+Numbast used to generate the bindings determines the compatible ``numba-cuda`` versions.
+
+.. list-table:: Numbast to numba-cuda compatibility
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Numbast Version
+     - Required numba-cuda Version
+   * - 0.6.0 (current dev)
+     - ``>=0.21.0,<0.23.0``
+   * - 0.5.x
+     - ``>=0.20.1,<0.21.0``
+
+**Why do generated bindings have version requirements?**
+
+Numbast generates Python code that uses Numba-CUDA's internal APIs. These APIs can change between releases, so
+bindings generated with a specific version of Numbast are tested against a specific range of ``numba-cuda`` versions.
+
+**How do I ensure compatibility?**
+
+*For dynamic binding generation:*
+
+- The correct ``numba-cuda`` version constraints are automatically enforced at the package dependency level
+  and managed by your package manager (pip or conda). When you install Numbast, compatible versions of
+  ``numba-cuda`` are installed automatically via the dependencies specified in ``pyproject.toml`` and Conda
+  environment files.
+
+*For static binding generation:*
+
+- When distributing generated bindings, document the required ``numba-cuda`` version range in your package
+  dependencies so users can install a compatible version.
+- Generated static bindings (see :doc:`Static binding generation <static>`) can be regenerated with newer
+  versions of Numbast if you need to support newer ``numba-cuda`` releases.
+
+.. note::
+   These version restrictions may be relaxed or removed once ``numba-cuda`` releases a stable 1.0 version with
+   stabilized public APIs. Until then, bindings are tested against specific version ranges to ensure compatibility.