chore(upgrade): add upgrade documentation

Author: joelwurtz

docs/_nav.md

@@ -25,5 +25,6 @@
     - [Api Platform](bundle/api-platform.md)
     - [Migrate existing application](bundle/migrate.md)
     - [Debugging](bundle/debugging.md)
-- [Upgrading to 9.0](upgrading-9.0.md)
+- [Upgrading](upgrading/upgrading-10.0.md)
+    - [Upgrading to 9.0](upgrading/upgrading-9.0.md)
 - [Contributing](contributing.md)

docs/mapping/transformer.md

@@ -135,7 +135,7 @@ class UrlTransformer implements PropertyTransformerInterface, PropertyTransforme
     {
     }
 
-    public function supports(TypesMatching $types, SourcePropertyMetadata $source, TargetPropertyMetadata $target, MapperMetadata $mapperMetadata): bool
+    public function supports(SourcePropertyMetadata $source, TargetPropertyMetadata $target, MapperMetadata $mapperMetadata): bool
     {
         return $source->type->isIdentifiedBy(TypeIdentifier::INT && $source->property === 'id' && $target->property === 'url';
     }

docs/upgrading/upgrading-10.0.md

@@ -0,0 +1,52 @@
+# Upgrading to 10.0
+
+10.0 is major release of AutoMapper. It aims at supporting the new [`TypeInfo` Component](https://symfony.com/doc/current/components/type_info.html) of Symfony
+
+There is little change between 9.X and 10.0 version, but they are still a BC break so it need a major version.
+
+## Custom Transformers
+
+If you were using the `PropertyTransformerSupportInterface` interface, its signature has changed to use the new `TypeInfo` component.
+
+Before: 
+
+```php
+class MyTransformer implements PropertyTransformerSupportInterface
+{
+    public function supports(TypesMatching $types, SourcePropertyMetadata $source, TargetPropertyMetadata $target, MapperMetadata $mapperMetadata): bool
+    {
+        // ...
+    }
+}
+```
+
+After:
+
+```php
+class MyTransformer implements PropertyTransformerSupportInterface
+{
+    public function supports(SourcePropertyMetadata $source, TargetPropertyMetadata $target, MapperMetadata $mapperMetadata): bool
+    {
+        // ...
+    }
+}
+```
+
+There is no more `TypesMatching` argument, you can get the source and target types from the `SourcePropertyMetadata` and `TargetPropertyMetadata` arguments, 
+which are instance of `Symfony\Component\TypeInfo\Type` class.
+
+```php
+class MyTransformer implements PropertyTransformerSupportInterface
+{
+    public function supports(SourcePropertyMetadata $source, TargetPropertyMetadata $target, MapperMetadata $mapperMetadata): bool
+    {
+        if ($source->type->isNullable()) {
+            return false;
+        }
+        
+        // ...
+    }
+}
+```
+
+See the [transformers documentation](../mapping/transformer.md#creating-a-custom-transformer) for more information.

docs/upgrading-9.0.md renamed to docs/upgrading/upgrading-9.0.md

@@ -1,28 +1,28 @@
-# Upgrading from 8.x to 9.0
-
-9.0 is major release of AutoMapper. It brings a lot of new features and improvements. We recommend first [to check 
-the new documentation](./index.md) to see if the new features are useful for your project.
-
-If you upgrade from 8.x to 9.0, you will need to make some changes to your code, but most of existing behavior should
-still work.
-
-## Bundle
-
-If you use the bundle, it is now integrated in the main package. You can remove the `jolicode/automapper-bundle` package from your
-`composer.json` file.
-
-Then you have to use the new namespace for the bundle:
-
-```php
-use AutoMapper\Symfony\Bundle\AutoMapperBundle;
-```
-
-You will also need to update the bundle configuration, see the [bundle documentation](./bundle/configuration.md) for more
-information.
-
-## Custom Transformers
-
-The `CustomPropertyTransformerInterface` and `CustomModelTransformerInterface` have been removed in favor of the 
-`PropertyTransformerInterface` interface handling both case.
-
-See the [transformers documentation](./mapping/transformer.md#creating-a-custom-transformer) for more information.
+# Upgrading to 10.0
+
+9.0 is major release of AutoMapper. It brings a lot of new features and improvements. We recommend first [to check
+the new documentation](../index.md) to see if the new features are useful for your project.
+
+If you upgrade from 8.x to 9.0, you will need to make some changes to your code, but most of existing behavior should
+still work.
+
+## Bundle
+
+If you use the bundle, it is now integrated in the main package. You can remove the `jolicode/automapper-bundle` package from your
+`composer.json` file.
+
+Then you have to use the new namespace for the bundle:
+
+```php
+use AutoMapper\Symfony\Bundle\AutoMapperBundle;
+```
+
+You will also need to update the bundle configuration, see the [bundle documentation](../bundle/configuration.md) for more
+information.
+
+## Custom Transformers
+
+The `CustomPropertyTransformerInterface` and `CustomModelTransformerInterface` have been removed in favor of the
+`PropertyTransformerInterface` interface handling both case.
+
+See the [transformers documentation](../mapping/transformer.md#creating-a-custom-transformer) for more information.