diff --git a/doc/source/multiple-environments.rst b/doc/source/multiple-environments.rst
index c0b2d9cbbfc3ea85bb88d34d3d810d411ac10ec1..1efc037f8b6e32e15ba4771dfe82af711deea5a3 100644
--- a/doc/source/multiple-environments.rst
+++ b/doc/source/multiple-environments.rst
@@ -2,6 +2,11 @@
 Multiple Environments
 =====================
 
+.. warning::
+
+    Support for multiple Kayobe environments is considered experimental: its
+    design may change in future versions without a deprecation period.
+
 Sometimes it can be useful to support deployment of multiple environments from
 a single Kayobe configuration. Most commonly this is to support a deployment
 pipeline, such as the traditional development, test, staging and production
diff --git a/releasenotes/notes/multiple-environments-2961e5ba017822dd.yaml b/releasenotes/notes/multiple-environments-2961e5ba017822dd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..63c051490b9b51c82899294993d0a657155ea805
--- /dev/null
+++ b/releasenotes/notes/multiple-environments-2961e5ba017822dd.yaml
@@ -0,0 +1,8 @@
+---
+features:
+  - |
+    Adds support for managing multiple Kayobe environments from a single
+    configuration repository. See the `documentation
+    <https://docs.openstack.org/kayobe/latest/multiple-environments.html>`__
+    for more details. Note that this feature is considered experimental: its
+    design may change in future versions without a deprecation period.