Minor docs' improvements

README.md

@@ -33,8 +33,11 @@ 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):
+
+- it allows to validate raw data of properties marked with `Validate` PHP attribute before passing it to the decorated 
+hydrator;
+- it allows to validate 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,7 +63,8 @@ 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:
 

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
 {