Update docs

Author: GromNaN

docs/en/reference/custom-mapping-types.rst

@@ -123,14 +123,14 @@ Custom Type Example: Mapping a UUID Class
 
 You can create a custom mapping type for your own value objects or classes. For
 example, to map a UUID value object using the `ramsey/uuid library`_, you can
-implement a type that converts between your class and the MongoDB binary format.
+implement a type that converts between your class and the BSON Binary UUID format.
 
-This approach works for any custom class—just adapt the conversion logic to your needs.
-
-Example Implementation (using Ramsey\Uuid\UuidInterface)::
+This approach works for any custom class by adapting the conversion logic to your needs.
 
+Example Implementation (using ``Ramsey\Uuid\Uuid``)::
 
 .. code-block:: php
+
     <?php
 
     namespace My\Project\Types;
@@ -144,6 +144,7 @@ Example Implementation (using Ramsey\Uuid\UuidInterface)::
 
     final class UuidType extends Type
     {
+        // This trait provides default closureToPHP used during data hydration
         use ClosureToPHP;
 
         public function convertToPHPValue(mixed $value): ?Uuid
@@ -203,23 +204,24 @@ Example Implementation (using Ramsey\Uuid\UuidInterface)::
         }
     }
 
-Usage Example::
+Register the type in your bootstrap code::
 
 .. code-block:: php
 
-    #[Field(type: Uuid::class)]
-    public Uuid $id;
+    Type::addType(Ramsey\Uuid\Uuid::class, My\Project\Types\UuidType::class);
 
-Register the type in your bootstrap code::
+Usage Example::
 
 .. code-block:: php
 
-    Type::addType(Ramsey\Uuid\Uuid::class, My\Project\Types\UuidType::class);
+    #[Field(type: Ramsey\Uuid\Uuid::class)]
+    public Ramsey\Uuid\Uuid $id;
 
 .. note::
-   The type name should match the support class name (e.g., ``uuid`` for ``UuidType``) to enable automatic association with the field type.
-
-This pattern can be adapted for any custom class—just implement the conversion logic for your value object.
+    The type name should be the name of the value object class (e.g., ``Ramsey\Uuid\Uuid``
+    for our custom ``UuidType``) to enable automatic transformation of the values
+    of this class in the aggregation builder.
 
-.. |FQCN| raw:: html <abbr title="Fully-Qualified Class Name">FQCN</abbr>
 .. _`ramsey/uuid library`: https://github.com/ramsey/uuid
+.. |FQCN| raw:: html
+  <abbr title="Fully-Qualified Class Name">FQCN</abbr>