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

[nicolas-grekas]

Symfony's debug:autowiring command displays the first line of the docblock of each autowirable type, as a hint about what the service is for. This PR adds or improves that line for the types this package registers for autowiring.

Same as symfony/symfony#66566, which does it for Symfony's own types.

[nicolas-grekas]

I dropped the hints I had added on PersistProcessor, RemoveProcessor and the UUID/ULID filters: these final classes are aliased by their FQCN, so debug:autowiring lists them as types to autowire. Type-hinting one breaks as soon as the service is decorated (TypeError, only lint:container catches it).

WDYT of deprecating the FQCN aliases of final classes that implement an interface, in favor of named aliases on the interface? Eg $container->registerAliasForArgument('api_platform.doctrine.orm.state.persist_processor', ProcessorInterface::class, 'persist') in the extension would let apps write:

public function __construct(
    #[Target('persist')] private ProcessorInterface $processor,
) {
}

debug:autowiring would then list the processors as variants of ProcessorInterface. That's what symfony/symfony#66568 does for Symfony's webhook parsers. The filter aliases point to abstract definitions and can't be autowired at all; symfony/symfony#66569 hides them from the listing.