Minor docs' improvements (#27)

* Fix docs

* Corrections

* Fix [skip ci]

* Review fix [skip ci]

* Update README.md

Co-authored-by: Alexander Makarov <[email protected]>

---------

Co-authored-by: Alexander Makarov <[email protected]>

README.md

@@ -33,8 +33,10 @@ composer require yiisoft/hydrator-validator
 
 ## General usage
 
-Validating hydrator is a [hydrator](https://github.com/yiisoft/hydrator) decorator that allows to validate
-raw data before passing it to the decorated hydrator and to validate object after creating or populating it.
+Validating hydrator is a decorator for [hydrator](https://github.com/yiisoft/hydrator) that allows to validate:
+
+- raw data of properties marked with `Validate` PHP attribute;
+- an object after creating or populating it.
 
 To use it, the object being validated must implement `ValidatedInputInterface`. You can use `ValidatedInputTrait` to
 easily create such object. The validation rules for raw values of the object are defined with `Validate` PHP attribute.
@@ -60,12 +62,13 @@ final class InputDto implements ValidatedInputInterface
 }
 ```
 
-Validation result could be obtained via `getValidationResult()` method.
+Validation result could be obtained via `getValidationResult()` method. For further working with result, refer to 
+corresponding [validator's guide section](https://github.com/yiisoft/validator/blob/master/docs/guide/en/result.md).
 
 Validating hydrator usage example:
 
 ```php
-use Yiisoft\Hydrator\HydratorInterface;
+use Psr\Http\Message\RequestInterface;
 use Yiisoft\Hydrator\Validator\ValidatingHydrator;
 
 public function actionEdit(RequestInterface $request, ValidatingHydrator $hydrator): ResponseInterface

src/Attribute/Validate.php

@@ -9,8 +9,8 @@
 use Yiisoft\Validator\RuleInterface;
 
 /**
- * Added to either property or parameter to indicate that raw values should be validated. Validation rules are passed
- * as arguments to the attribute.
+ * Added to either property or parameter to indicate that raw values should be validated. Validation rules are passed as
+ * arguments to the attribute.
  */
 #[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_PARAMETER | Attribute::IS_REPEATABLE)]
 final class Validate implements ParameterAttributeInterface

src/ValidatedInputInterface.php

@@ -9,8 +9,7 @@
 use Yiisoft\Validator\Result;
 
 /**
- * `ValidatedInputInterface` is an interface for objects that can be validated.
- * It provides a method to get validation result.
+ * Used for objects that can be validated. It provides a method to get validation result.
  *
  * You can use {@see ValidatedInputTrait} to implement this interface.
  */

src/ValidatingHydrator.php

@@ -11,7 +11,11 @@
 use Yiisoft\Validator\ValidatorInterface;
 
 /**
- * `ValidatingHydrator` is a decorator for {@see HydratorInterface} that validates data before hydration.
+ * `ValidatingHydrator` is a decorator for {@see HydratorInterface}:
+ *
+ * - it allows to validate raw data of properties marked with {@see Validate} PHP attribute before passing it to the
+ * decorated hydrator;
+ * - it allows to validate object after creating or populating it.
  */
 final class ValidatingHydrator implements HydratorInterface
 {