docs: describe the types listed by Symfony's debug:autowiring command

Author: nicolas-grekas

src/Doctrine/Common/State/PersistProcessor.php

@@ -22,6 +22,9 @@
 use Doctrine\Persistence\ManagerRegistry;
 use Doctrine\Persistence\ObjectManager as DoctrineObjectManager;
 
+/**
+ * Persists and flushes the data of write operations with Doctrine.
+ */
 final class PersistProcessor implements ProcessorInterface
 {
     use ClassInfoTrait;

src/Doctrine/Common/State/RemoveProcessor.php

@@ -19,6 +19,9 @@
 use Doctrine\Persistence\ManagerRegistry;
 use Doctrine\Persistence\ObjectManager as DoctrineObjectManager;
 
+/**
+ * Removes the data of delete operations with Doctrine.
+ */
 final class RemoveProcessor implements ProcessorInterface
 {
     use ClassInfoTrait;

src/Doctrine/Orm/Filter/UlidFilter.php

@@ -17,6 +17,9 @@
 use ApiPlatform\Metadata\QueryParameter;
 use ApiPlatform\OpenApi\Model\Parameter as OpenApiParameter;
 
+/**
+ * Filters a collection by ULID.
+ */
 final class UlidFilter extends AbstractUuidFilter
 {
     private const ULID_SCHEMA = [

src/Doctrine/Orm/Filter/UuidBinaryFilter.php

@@ -18,6 +18,9 @@
 use Doctrine\DBAL\ArrayParameterType;
 use Doctrine\DBAL\ParameterType;
 
+/**
+ * Filters a collection by UUID, for UUIDs stored in binary columns.
+ */
 final class UuidBinaryFilter extends AbstractUuidFilter
 {
     public function __construct()

src/Doctrine/Orm/Filter/UuidFilter.php

@@ -13,6 +13,9 @@
 
 namespace ApiPlatform\Doctrine\Orm\Filter;
 
+/**
+ * Filters a collection by UUID.
+ */
 final class UuidFilter extends AbstractUuidFilter
 {
 }

src/Metadata/Operation/Factory/OperationMetadataFactoryInterface.php

@@ -15,6 +15,9 @@
 
 use ApiPlatform\Metadata\Operation;
 
+/**
+ * Finds the operation that matches a URI template or an operation name.
+ */
 interface OperationMetadataFactoryInterface
 {
     public function create(string $uriTemplate, array $context = []): ?Operation;

src/Metadata/ResourceAccessCheckerInterface.php

@@ -13,6 +13,9 @@
 
 namespace ApiPlatform\Metadata;
 
+/**
+ * Checks if the current user can access a resource, with a security expression.
+ */
 interface ResourceAccessCheckerInterface
 {
     /**

src/Metadata/UrlGeneratorInterface.php

@@ -18,7 +18,7 @@
 use Symfony\Component\Routing\Exception\RouteNotFoundException;
 
 /**
- * UrlGeneratorInterface is the interface that all URL generator classes must implement.
+ * Generates URLs and paths from route names and parameters.
  *
  * This interface has been imported and adapted from the Symfony project.
  *

src/OpenApi/Factory/OpenApiFactoryInterface.php

@@ -15,6 +15,9 @@
 
 use ApiPlatform\OpenApi\OpenApi;
 
+/**
+ * Creates the OpenAPI document of the API.
+ */
 interface OpenApiFactoryInterface
 {
     /**

src/OpenApi/Options.php

@@ -15,6 +15,9 @@
 
 use ApiPlatform\OpenApi\Model\Tag;
 
+/**
+ * Holds the options of the OpenAPI document, such as its title, version and authentication schemes.
+ */
 final readonly class Options
 {
     /**