Tweaks and improvements

Author: javiereguiluz

contributing/translations/index.rst

@@ -3,8 +3,8 @@ Contributing Translations
 
 Some Symfony Components include certain messages that must be translated to
 different languages. For example, if a user submits a form with a wrong value in
-a :doc:`TimezoneType </reference/forms/types/timezone>` field, Symfony shows by
-default the following error message: "This value is not a valid timezone."
+a :doc:`TimezoneType </reference/forms/types/timezone>` field, Symfony shows the
+following error message by default: "This value is not a valid timezone."
 
 These messages are translated into tens of languages thanks to the Symfony
 community. Symfony adds new messages on a regular basis, so this is an ongoing
@@ -21,22 +21,23 @@ Symfony repository. Visit the `Symfony Releases`_ page to find out which is the
 current oldest maintained branch.
 
 If you know Git well, clone the Symfony repository and check out that branch.
-Otherwise, visit https://github.com/symfony/symfony and switch to that branch.
+Otherwise, visit `https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_
+and switch to that branch.
 
-**Step 2.** Check out if there's some missing translation in your language.
-You only have to check these directories:
+**Step 2.** Check out if there's some missing translation in your language by
+checking these directories:
 
 * ``src/Symfony/Component/Form/Resources/translations/``
 * ``src/Symfony/Component/Security/Core/Resources/translations/``
 * ``src/Symfony/Component/Validator/Resources/translations/``
 
 Symfony uses the :ref:`XLIFF format <best-practice-internationalization>` to
 store translations. In this example, you are looking for missing Swedish
-translations, so you should look for files called ``*.se.xlf``.
+translations, so you should look for files called ``*.sv.xlf``.
 
 .. note::
 
-    If there's no XLIFF file yet for your language, create it yourself
+    If there's no XLIFF file for your language yet, create it yourself
     duplicating the original English file (e.g. ``validators.en.xlf``).
 
 **Step 3.** Contribute the missing translations. To do that, compare the file
@@ -46,6 +47,8 @@ Imagine that you open the ``validators.sv.xlf`` and see this at the end of the f
 
 .. code-block:: xml
 
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.sv.xlf -->
+
     <!-- ... -->
     <trans-unit id="91">
         <source>This value should be either negative or zero.</source>
@@ -61,6 +64,8 @@ English file has more messages to translate:
 
 .. code-block:: xml
 
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.en.xlf -->
+
     <!-- ... -->
     <trans-unit id="91">
         <source>This value should be either negative or zero.</source>
@@ -79,12 +84,14 @@ English file has more messages to translate:
         <target>This value should be between {{ min }} and {{ max }}.</target>
     </trans-unit>
 
-The messages with ``id = 93`` and ``id = 94`` are missing in the Swedish file.
+The messages with ``id=93`` and ``id=94`` are missing in the Swedish file.
 Copy and paste the messages from the English file, translate the content
 inside the ``<target>`` tag and save the changes.
 
-**Step 4.** Make the pull request against the Symfony GitHub repository. If you
-need help, check the other Symfony guides about :doc:`contributing code or docs </contributing/index>`
-because the process is the same.
+**Step 4.** Make the pull request against the
+`https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_ repository.
+If you need help, check the other Symfony guides about
+:doc:`contributing code or docs </contributing/index>` because the process is
+the same.
 
 .. _`Symfony Releases`: https://symfony.com/releases