Extra improvements based on comments

Author: raulfraile

components/translation/custom_formats.rst

@@ -5,28 +5,28 @@ Custom Formats
 ==============
 
 Sometimes, you need to deal with custom formats for translation files. The
-Translation component is flexible enough to support this, just creating a
+Translation component is flexible enough to support this. Just create a
 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
+Imagine that you have a custom format where translation messages are defined
+using one line for each translation and parentheses to wrap the key and the
 message. A translation file would look like this:
 
 .. code-block:: text
 
     (welcome)(Bienvenido)
-    (goodbye)(Adios)
+    (goodbye)(Adiós)
     (hello)(Hola)
 
 Custom Loader
 -------------
 
-To define a custom loader able to read this kind of files, you must create a
+To define a custom loader that is able to read this kind of files, you must create a
 new class that implements the
 :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`. The
 :method:`Symfony\\Component\\Translation\\Loader\\LoaderInterface::load`
 method will get a filename and parse it into an array. Then, it will
-create the catalogue that will be returned::
+create the catalog that will be returned::
 
     use Symfony\Component\Translation\MessageCatalogue;
     use Symfony\Component\Translation\Loader\LoaderInterface;
@@ -54,6 +54,8 @@ create the catalogue that will be returned::
 
 Once created, it can be used as any other loader::
 
+    use Symfony\Component\Translation\Translator;
+
     $translator = new Translator('es_ES');
     $translator->addLoader('my_format', new MyFormatLoader());
 
@@ -66,10 +68,11 @@ It will print *"Bienvenido"*.
 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
+It is also possible to create a custom dumper for your format, which is
+useful when using the extraction commands. To do so, a new class
+implementing the
 :class:`Symfony\\Component\\Translation\\Dumper\\DumperInterface`
-interface must be created.
+ must be created.
 To write the dump contents into a file, extending the
 :class:`Symfony\\Component\\Translation\\Dumper\\FileDumper` class
 will save a few lines::
@@ -79,8 +82,7 @@ will save a few lines::
 
     class MyFormatDumper extends FileDumper
     {
-
-        public function format(MessageCatalogue $messages, $domain = 'messages')
+        protected function format(MessageCatalogue $messages, $domain = 'messages')
         {
             $output = '';
 
@@ -100,15 +102,12 @@ will save a few lines::
 The :method:`Symfony\\Component\\Translation\\Dumper\\FileDumper::format`
 method creates the output string, that will be used by the
 :method:`Symfony\\Component\\Translation\\Dumper\\FileDumper::dump` method
-of the :class:`Symfony\\Component\\Translation\\Dumper\\FileDumper` class to
-create the file. The dumper can be used like any other
-built-in dumper. In this example, the translation messages defined in the YAML file
-are dumped into a text file with the custom format::
+of the FileDumper class to create the file. The dumper can be used like any other
+built-in dumper. In the following example, the translation messages defined in the
+YAML file are dumped into a text file with the custom format::
 
     use Symfony\Component\Translation\Loader\YamlFileLoader;
 
-    include_once __DIR__. '/vendor/autoload.php';
-
     $loader = new YamlFileLoader();
     $catalogue = $loader->load(__DIR__ . '/translations/messages.es_ES.yml' , 'es_ES');
 

components/translation/introduction.rst

@@ -62,9 +62,7 @@ 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
-default loaders are:
+The component comes with some default loaders:
 
 * :class:`Symfony\\Component\\Translation\\Loader\\ArrayLoader` - to load
   catalogs from PHP arrays.
@@ -96,6 +94,9 @@ default loaders are:
 
 All file loaders require the :doc:`Config component </components/config/index>`.
 
+You can also :doc:`create your own Loader </components/translation/custom_formats>`,
+in case the format is not already supported by one of the default loaders.
+
 At first, you should add one or more loaders to the ``Translator``::
 
     // ...