diff --git a/doc/CONTRIBUTING.rst b/doc/CONTRIBUTING.rst
index a060681423a8dacd2bf2d61f19415034a550ed21..7eb7e0e04dc3536b662e1feb31eb913c0c8cd12f 100644
--- a/doc/CONTRIBUTING.rst
+++ b/doc/CONTRIBUTING.rst
@@ -167,6 +167,10 @@ that Kolla uses throughout that should be followed.
   - For infrastructure services there should be an entry in the list
     ``Infrastructure components`` in the ``README.rst`` file.
 
+* Syntax
+
+  - All YAML data files should start with three dashes (``---``).
+
 Other than the above, most roles follow the following pattern:
 
   -  ``Register``: Involves registering the service with Keystone, creating endpoints, roles,