symfony
diff --git a/‎components/type_info.rst
Copy file name to clipboardExpand all lines: components/type_info.rst
+13-1Lines changed: 13 additions & 1 deletion b/‎components/type_info.rst
Copy file name to clipboardExpand all lines: components/type_info.rst
+13-1Lines changed: 13 additions & 1 deletion
@@ -7,6 +7,10 @@ The TypeInfo Component
 
     - Being able to get types from anything, such as properties, method arguments, return types, and raw strings (and can also be extended).
 
+.. caution::
+
+    This component is :doc:`experimental </contributing/code/experimental>` and could be changed at any time
+    without prior notice.
 
 Installation
 ------------
@@ -20,7 +24,10 @@ Installation
 Usage
 -----
 
-There is two ways to use this component. First one is to create a manually thanks
+This component will gives you a :class:`Symfony\\Component\\TypeInfo\\Type` object that represents
+the PHP type of whatever you builded or asked to resolve.
+
+There are two ways to use this component. First one is to create a type manually thanks
 to :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
 
     use Symfony\Component\TypeInfo\Type;
@@ -34,6 +41,7 @@ to :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     // Many others are available and can be
     // found in Symfony\Component\TypeInfo\TypeFactoryTrait
 
+
 Second way to use TypeInfo is to resolve a type based on reflection or a simple string::
 
     use Symfony\Component\TypeInfo\Type;
@@ -54,6 +62,10 @@ Second way to use TypeInfo is to resolve a type based on reflection or a simple
     $type->getCollectionKeyType(); // returns an "int" Type instance
     $type->getCollectionValueType()->isNullable(); // returns true
 
+Each of this rows will return you a Type instance that will corresponds to whatever static method you used to build it.
+We also can resolve a type from a string like we can see in this example with the `'bool'` parameter it is mostly
+designed that way so we can give TypeInfo a string from whatever was extracted from existing phpDoc within PropertyInfo.
+
 .. note::
 
     To support raw string resolving, you need to install ``phpstan/phpdoc-parser`` package.