Improvements based on comments

Author: raulfraile

components/map.rst.inc

@@ -130,6 +130,7 @@
 
   * :doc:`/components/translation/introduction`
   * :doc:`/components/translation/usage`
+  * :doc:`/components/translation/custom_formats`
 
 * :doc:`/components/yaml/index`
 

components/translation/custom_formats.rst

@@ -1,7 +1,7 @@
 .. index::
     single: Translation; Custom formats
 
-Custom formats
+Custom Formats
 ==============
 
 Sometimes, you need to deal with custom formats for translation files. The
@@ -10,19 +10,23 @@ loader (to load translations) and, optionally, a dumper (to dump translations).
 
 Let's imagine you have a custom format where translation messages are defined
 using one line for each translation and parenthesis to wrap the key and the
-message. A translation file would look like this::
+message. A translation file would look like this:
+
+.. code-block:: text
 
     (welcome)(Bienvenido)
     (goodbye)(Adios)
     (hello)(Hola)
 
+Custom Loader
+-------------
+
 To define a custom loader able to read this kind of files, you must create a
 new class that implements the
-:class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface,
-which defines a
+:class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`. The
 :method:`Symfony\\Component\\Translation\\Loader\\LoaderInterface::load`
-method. In the loader, this method will get a filename and parse it to create an
-array. Then, it will create the catalog that will be returned::
+method will get a filename and parse it into an array. Then, it will
+create the catalogue that will be returned::
 
     use Symfony\Component\Translation\MessageCatalogue;
     use Symfony\Component\Translation\Loader\LoaderInterface;
@@ -59,8 +63,11 @@ Once created, it can be used as any other loader::
 
 It will print *"Bienvenido"*.
 
-It is also possible to create a custom dumper for your format. To do so,
-a new class implementing the
+Custom Dumper
+-------------
+
+It is also possible to create a custom dumper for your format, useful when using
+the extraction commands. To do so, a new class implementing the
 :class:`Symfony\\Component\\Translation\\Dumper\\DumperInterface`
 interface must be created.
 To write the dump contents into a file, extending the

components/translation/introduction.rst

@@ -62,8 +62,8 @@ The Translation component uses Loader classes to load catalogs. You can load
 multiple resources for the same locale, which will then be combined into one
 catalog.
 
-The component comes with some default Loaders and you can
-:doc:`create your own Loader too</components/translation/custom_formats>`. The
+The component comes with some default loaders and you can
+:doc:`create your own Loader too </components/translation/custom_formats>`. The
 default loaders are:
 
 * :class:`Symfony\\Component\\Translation\\Loader\\ArrayLoader` - to load