Applied comments by @cordoval

wouterj · weaverryan · commit 84f45248cdbd · 2016-07-31T09:39:59.000-04:00
diff --git a/components/validator/introduction.rst b/components/validator/introduction.rst
@@ -20,8 +20,8 @@ Usage
 -----
 
 The Validator component allows you to use very advanced validation rules, but
-it is also really easy to do very minor validation. For instance, if you want
-to validate a string against a specific length, the only code you need is::
+it is also really easy to do easy validation tasks. For instance, if you want
+to validate a string is at least 10 character long, the only code you need is::
 
     use Symfony\Component\Validator\Validation;
     use Symfony\Component\Validator\Constraints\Length;
@@ -31,7 +31,7 @@ to validate a string against a specific length, the only code you need is::
     $violations = $validator->validateValue('Bernhard', new Length(array('min' => 10)));
 
     if (0 !== count($violations)) {
-        // there are errors, let's show them
+        // there are errors, now you can show them
         foreach ($violations as $violation) {
             echo $violation->getMessage().'<br>';
         }
@@ -42,19 +42,20 @@ Retrieving a Validator Instance
 
 The :class:`Symfony\\Component\\Validator\\Validator` class is the main access
 point of the Validator component. To create a new instance of this class, it
-is recomment to use the :class:`Symfony\\Component\Validator\Validation`
+is recommend to use the :class:`Symfony\\Component\Validator\Validation`
 class.
 
-You can get the ``Validator`` with the default configuration by calling 
+You can get a very basic ``Validator`` by calling 
 :method:`Validation::createValidator() <Symfony\\Component\\Validator\\Validation::createValidator>`::
 
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidator();
 
-However, a lot of things can be customized. To configure the ``Validator``
-class, you can use the :class:`Symfony\\Component\\Validator\\ValidatorBuilder`.
-This class can be retrieved by using the 
+The created validator can be used to validate strings, array, numbers, but it
+can't validate classes. To be able to do that, you have to configure the ``Validator``
+class. To do that, you can use the :class:`Symfony\\Component\\Validator\\ValidatorBuilder`.
+This class can be retrieved by using the
 :method:`Validation::createValidatorBuilder() <Symfony\\Component\\Validator\\Validation::createValidatorBuilder>`
 method::
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
@@ -7,7 +7,7 @@ Loading Resources
 The Validator uses metadata to validate a value. This metadata defines how a
 class, array or any other value should be validated. When validating a class,
 each class contains its own specific metadata. When validating another value,
-the metadata to passed to the validate methods.
+the metadata must be passed to the validate methods.
 
 Class metadata should be defined somewhere in a configuration file, or in the
 class itself. The ``Validator`` needs to be able to retrieve this metadata
@@ -20,7 +20,7 @@ from the file or class. To do that, it uses a set of loaders.
 The StaticMethodLoader
 ----------------------
 
-The easiest loader is the
+The most basic loader is the
 :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\StaticMethodLoader`.
 This loader will call a static method of the class in order to get the
 metadata for that class. The name of the method is configured using the
@@ -34,7 +34,7 @@ method of the Validator builder::
         ->getValidator();
 
 Now, the retrieved ``Validator`` tries to find the ``loadValidatorMetadata()``
-method of the validated class to load its metadata.
+method of the class to validate to load its metadata.
 
 .. tip::
 
@@ -70,8 +70,9 @@ The AnnotationLoader
 
 At last, the component provides an
 :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader`.
-This loader will parse the annotations of a class. Annotations are placed in
-PHPdoc comments (`/** ... */`) and start with an ``@``. For instance::
+This loader uses an annotation reader to parse the annotations of a class.
+Annotations are placed in doc block comments (`/** ... */`) and start with an
+``@``. For instance::
 
     // ...
 
@@ -97,7 +98,7 @@ To disable the annotation loader after it was enabled, call
 .. note::
 
     In order to use the annotation loader, you should have installed the
-    ``doctrine/annotations`` and ``doctrine/cache`` packages of Packagist.
+    ``doctrine/annotations`` and ``doctrine/cache`` packages from Packagist.
 
 Using Multiple Loaders
 ----------------------
@@ -121,9 +122,9 @@ multiple mappings::
 Caching
 -------
 
-Using many loaders to load metadata from different places is very easy for the
-developer, but it can easily slow down your application since each file needs
-to be parsed, validated and converted to a
+Using many loaders to load metadata from different places is very easy when
+creating the metadata, but it can easily slow down your application since each
+file needs to be parsed, validated and converted to a
 :class:`Symfony\\Component\\Validator\\Mapping\\ClassMetadata` instance. To
 solve this problems, you can configure a cacher which will be used to cache
 the ``ClassMetadata`` after it was loaded.
@@ -135,10 +136,11 @@ implements :class:`Symfony\\Component\\Validator\\Mapping\\Cache\\CacheInterface
 
 .. note::
 
-    The loader already use a singleton load mechanism. That means that they
-    will only load and parse a file once and put that in a property, which
-    will be used on the next time. However, the Validator still needs to
-    merge all metadata of one class from every loader when it is requested.
+    The loaders already use a singleton load mechanism. That means that the
+    loaders will only load and parse a file once and put that in a property,
+    which will then be used the next time it is asked for metadata. However,
+    the Validator still needs to merge all metadata of one class from every
+    loader when it is requested.
 
 To set a cacher, call the
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::setMetadataCache` of
@@ -176,5 +178,5 @@ this custom implementation using
 .. caution::
 
     Since you are using a custom metadata factory, you can't configure loaders
-    and cachers using the helper methods anymore. You now have to inject them
-    into your custom metadata factory yourself.
+    and cachers using the ``add*Mapping()`` methods anymore. You now have to
+    inject them into your custom metadata factory yourself.
