Added formats standards

Author: wouterj

contributing/documentation/format.rst

@@ -52,6 +52,8 @@ the highlighted pseudo-language:
 
     A list of supported languages is available on the `Pygments website`_.
 
+.. _docs-configuration-blocks:
+
 Configuration Blocks
 ~~~~~~~~~~~~~~~~~~~~
 

contributing/documentation/standards.rst

@@ -65,6 +65,17 @@ Code Examples
   unless the next line is also a comment;
 * You should put a ``$`` in front of every bash line.
 
+Formats
+~~~~~~~
+
+Configuration examples should show all supported formats using
+:ref:`configuration blocks <docs-configuration-blocks>`. The supported formats
+(and their orders) are:
+
+* **Configuration** (including services and routing): Yaml, Xml, Php
+* **Validation**: Yaml, Annotations, Xml, Php
+* **Doctrine Mapping**: Annotations, Yaml, Xml, Php
+
 Example
 ~~~~~~~