fix(metadata): ApiResource: add some return types and fix PHPdoc (api-platform#4425)

Author: dunglas

src/Metadata/Resource/Factory/AttributesResourceMetadataCollectionFactory.php

@@ -35,14 +35,15 @@
 use Psr\Log\NullLogger;
 
 /**
- * Creates a resource metadata from {@see Resource} annotations.
+ * Creates a resource metadata from {@see ApiResource} annotations.
  *
  * @author Antoine Bluchet <[email protected]>
  * @experimental
  */
 final class AttributesResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
     use DeprecationMetadataTrait;
+
     private $defaults;
     private $decorated;
     private $logger;
@@ -216,7 +217,7 @@ private function getOperationWithDefaults(ApiResource $resource, $operation): ar
         ];
     }
 
-    private function getResourceWithDefaults(string $resourceClass, string $shortName, ApiResource $resource)
+    private function getResourceWithDefaults(string $resourceClass, string $shortName, ApiResource $resource): ApiResource
     {
         $resource = $resource
                         ->withShortName($shortName)
@@ -262,7 +263,7 @@ private function hasSameOperation(ApiResource $resource, string $operationClass,
         return false;
     }
 
-    private function addDefaultGraphQlOperations(ApiResource $resource)
+    private function addDefaultGraphQlOperations(ApiResource $resource): ApiResource
     {
         $graphQlOperations = [];
         foreach ([new QueryCollection(), new Query(), (new Mutation())->withName('update'), (new Mutation())->withName('delete'), (new Mutation())->withName('create')] as $i => $operation) {