minor #4112 [Contributing][Documentation] add order of translation formats (xabbuh)

weaverryan · weaverryan · commit 03fcab142743 · 2014-08-16T13:05:35.000-04:00
This PR was merged into the 2.3 branch. Discussion ---------- [Contributing][Documentation] add order of translation formats | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no | Applies to | all | Fixed tickets | Commits ------- ef4dd23 add order of translation formats
diff --git a/book/translation.rst b/book/translation.rst
@@ -136,18 +136,18 @@ different formats, XLIFF being the recommended format:
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # messages.fr.yml
+        Symfony2 is great: J'aime Symfony2
+
     .. code-block:: php
 
         // messages.fr.php
         return array(
             'Symfony2 is great' => 'J\'aime Symfony2',
         );
 
-    .. code-block:: yaml
-
-        # messages.fr.yml
-        Symfony2 is great: J'aime Symfony2
-
 For information on where these files should be located, see
 :ref:`book-translation-resource-locations`.
 
@@ -638,18 +638,18 @@ bundle.
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        # validators.en.yml
+        author.name.not_blank: Please enter an author name.
+
     .. code-block:: php
 
         // validators.en.php
         return array(
             'author.name.not_blank' => 'Please enter an author name.',
         );
 
-    .. code-block:: yaml
-
-        # validators.en.yml
-        author.name.not_blank: Please enter an author name.
-
 Translating Database Content
 ----------------------------
 
diff --git a/components/translation/usage.rst b/components/translation/usage.rst
@@ -127,18 +127,18 @@ recommended format. These files are parsed by one of the loader classes.
             </file>
         </xliff>
 
+    .. code-block:: yaml
+
+        Symfony2 is great: J'aime Symfony2
+        symfony2.great:    J'aime Symfony2
+
     .. code-block:: php
 
         return array(
             'Symfony2 is great' => 'J\'aime Symfony2',
             'symfony2.great'    => 'J\'aime Symfony2',
         );
 
-    .. code-block:: yaml
-
-        Symfony2 is great: J'aime Symfony2
-        symfony2.great:    J'aime Symfony2
-
 .. sidebar:: Using Real or Keyword Messages
 
     This example illustrates the two different philosophies when creating
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
@@ -80,6 +80,7 @@ Configuration examples should show all supported formats using
 * **Configuration** (including services and routing): YAML, XML, PHP
 * **Validation**: YAML, Annotations, XML, PHP
 * **Doctrine Mapping**: Annotations, YAML, XML, PHP
+* **Translation**: XML, YAML, PHP
 
 Example
 ~~~~~~~
