diff --git a/docs/plugin_guide/source/intro.rst b/docs/plugin_guide/source/intro.rst
index 4679883..23e5083 100644
--- a/docs/plugin_guide/source/intro.rst
+++ b/docs/plugin_guide/source/intro.rst
@@ -26,7 +26,12 @@ Fuel                    9.0
 Limitations
 -----------
 
-Murano plugin has no issues or limitations of usage.
+* Murano plugin is known to conflict with Contrail plugin. The reason is that
+  both ``murano-api`` and ``contrail-api`` services use 8082 as their
+  default port. To resolve this, please specify a
+  custom port for ``contrail-api`` in Contrail plugin.
+
+See also release-notes for any release-specific known issues.
 
 Licenses
 --------
@@ -47,4 +52,4 @@ see:
 
 * `Launchpad project <https://launchpad.net/fuel-plugin-murano>`__
 
-* `GitHub project <http://git.openstack.org/cgit/openstack/fuel-plugin-murano>`__
\ No newline at end of file
+* `GitHub project <http://git.openstack.org/cgit/openstack/fuel-plugin-murano>`__
diff --git a/releasenotes/notes/1.0.0-issues-c40e3b39565bb6b3.yaml b/releasenotes/notes/1.0.0-issues-c40e3b39565bb6b3.yaml
new file mode 100644
index 0000000..e92dfa1
--- /dev/null
+++ b/releasenotes/notes/1.0.0-issues-c40e3b39565bb6b3.yaml
@@ -0,0 +1,7 @@
+---
+issues:
+  - Murano services will not operate correctly when installed on a separate detached node, if you're installing
+    ``fuel-plugin-murano`` in an environment that contains Murano, bundled with Fuel 9.0. This happens because
+    ``murano-engine`` service on controller nodes is still active. As a workaround, you need to disable ``murano-engine``
+    service on controller nodes manually after installing ``fuel-plugin-murano``.
+  - Deploying Cloud Foundry integration service with this release of ``fuel-plugin-murano`` does not work correctly.