Add API warning

Signed-off-by: brycegbrazen <[email protected]>
AcademySoftwareFoundation · Jan 8, 2024 · e3c15d5 · e3c15d5
1 parent 7e8617d
commit e3c15d5
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/source/api.rst b/docs/source/api.rst
@@ -2,6 +2,13 @@
 Python API
 ==========
 
+WARNING
+=============
+Please note the following warnings prior to using the Rez Python API:
+
+* We try our best to not break users, but there are no compatibility guarantees between different versions of Rez.
+* The Python API does not currently support rereading from configuration files, or changing to new configuration files after the Python API has initially been imported. If you need to support this functionality, prefer the CLI instead.
+
 .. autosummary::
    :toctree: api
    :recursive: