Describe strict mode, rearrange info

docs/guide/en/README.md

@@ -3,9 +3,9 @@
 The package provides a way to create and hydrate objects from a set of raw data.
 
 - [General usage](general-usage.md)
+- [Type casting](typecasting.md)
+- [Mapping](mapping.md)
 - [Configuration with PHP attributes](configuration-with-attributes.md)
 - [Creating own attributes](creating-own-attributes.md)
 - Attribute reslover factory
 - Object factory
-- [Mapping](mapping.md)
-- [Type casting](typecasting.md)

docs/guide/en/configuration-with-attributes.md

@@ -2,20 +2,6 @@
 
 You can configure how the hydrator creates or hydrates a specific class using attributes.
 
-## Skipping hydration
-
-To skip hydration of a specific property, use `SkipHydration` attribute:
-
-```php
-use \Yiisoft\Hydrator\Attribute\SkipHydration;
-
-class MyClass
-{
-    #[SkipHydration]
-    private $property;
-}
-```
-
 ## Resolving dependencies
 
 To resolve dependencies by specific ID using DI container, use `Di` attribute:

docs/guide/en/general-usage.md

@@ -53,5 +53,3 @@ $object = $hydrator->create(Car::class, [
 
 That would pass the `name` constructor argument of the `Car` object and create a new `Engine` object for `engine`
 argument passing `V8` as the `name` argument to its constructor.
-
-// TODO: strict mode

docs/guide/en/mapping.md

@@ -33,16 +33,33 @@ $data = ['header' => 'First post', 'text' => 'Hello, world!'];
 Hydrator allows you to map data: 
 
 ```php
-$hydrator = new Hydrator();
+use Yiisoft\Hydrator\Hydrator;
+use Yiisoft\Hydrator\ArrayData;
 
-$object = new SimpleClass();
+$hydrator = new Hydrator();
 
 $map = ['title' => 'header', 'body' => 'text'],;
-$hydrator->hydrate($object, new ArrayData($data, $map));
+$post = $hydrator->create(Post::class, new ArrayData($data, $map));
 ```
 
 This way we take `header` key for `title` and `text` key for `body`.
 
+## Strict mode
+
+You can enable strict mode by passing `true` as a third argument of `ArrayData`:
+
+```php
+use Yiisoft\Hydrator\Hydrator;
+use Yiisoft\Hydrator\ArrayData;
+
+$hydrator = new Hydrator();
+
+$map = ['title' => 'header', 'body' => 'text'],;
+$post = $hydrator->create(Post::class, new ArrayData($data, $map, true));
+```
+
+In this case, keys absent from the map are ignored so everything should be mapped explicitly.
+
 ## Using attributes
 
 Alternatively to specifying mapping as an array, you can use `Data` attribute to define mapping inline:
@@ -65,3 +82,15 @@ $person = $hydrator->create(Person::class, [
     'last_name' => 'Doe',
 ]);
 ```
+
+To skip hydration of a specific property, use `SkipHydration` attribute:
+
+```php
+use \Yiisoft\Hydrator\Attribute\SkipHydration;
+
+class MyClass
+{
+    #[SkipHydration]
+    private $property;
+}
+```

docs/guide/en/typecasting.md

@@ -113,5 +113,3 @@ $money = $hydrator->create(Money::class, [
     'currency' => 'AMD',
 ]);
 ```
-
-