chore: remove @experimental phpdoc (#4933)

soyuka · web-flow · commit 5b7d97fea557 · 2022-09-09T16:47:06.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,7 @@
 
 ## 2.7.0
 
+* chore: remove @experimental phpdoc (#4933)
 * Metadata: do not set id when identifier is `false` (#4880)
 * Metadata: automatic GET operation when none is declared (#4881)
 * Metadata: exception to status on operations (#4861)
diff --git a/src/Core/Bridge/Doctrine/EventListener/PublishMercureUpdatesListener.php b/src/Core/Bridge/Doctrine/EventListener/PublishMercureUpdatesListener.php
@@ -37,8 +37,6 @@
  * Publishes resources updates to the Mercure hub.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class PublishMercureUpdatesListener
 {
diff --git a/src/Doctrine/EventListener/PublishMercureUpdatesListener.php b/src/Doctrine/EventListener/PublishMercureUpdatesListener.php
@@ -39,8 +39,6 @@
  * Publishes resources updates to the Mercure hub.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class PublishMercureUpdatesListener
 {
diff --git a/src/Doctrine/EventListener/PurgeHttpCacheListener.php b/src/Doctrine/EventListener/PurgeHttpCacheListener.php
@@ -35,8 +35,6 @@
  * Purges responses containing modified entities from the proxy cache.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class PurgeHttpCacheListener
 {
diff --git a/src/Doctrine/Odm/Extension/AggregationCollectionExtensionInterface.php b/src/Doctrine/Odm/Extension/AggregationCollectionExtensionInterface.php
@@ -19,8 +19,6 @@
 /**
  * Interface of Doctrine MongoDB ODM aggregation extensions for collection aggregations.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 interface AggregationCollectionExtensionInterface
diff --git a/src/Doctrine/Odm/Extension/AggregationItemExtensionInterface.php b/src/Doctrine/Odm/Extension/AggregationItemExtensionInterface.php
@@ -19,8 +19,6 @@
 /**
  * Interface of Doctrine MongoDB ODM aggregation extensions for item aggregations.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 interface AggregationItemExtensionInterface
diff --git a/src/Doctrine/Odm/Extension/AggregationResultCollectionExtensionInterface.php b/src/Doctrine/Odm/Extension/AggregationResultCollectionExtensionInterface.php
@@ -20,8 +20,6 @@
  * Interface of Doctrine MongoDB ODM aggregation extensions that supports result production
  * for specific cases such as pagination.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 interface AggregationResultCollectionExtensionInterface extends AggregationCollectionExtensionInterface
diff --git a/src/Doctrine/Odm/Extension/AggregationResultItemExtensionInterface.php b/src/Doctrine/Odm/Extension/AggregationResultItemExtensionInterface.php
@@ -20,8 +20,6 @@
  * Interface of Doctrine MongoDB ODM aggregation extensions that supports result production
  * for specific cases such as Aggregation alteration.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 interface AggregationResultItemExtensionInterface extends AggregationItemExtensionInterface
diff --git a/src/Doctrine/Odm/Extension/FilterExtension.php b/src/Doctrine/Odm/Extension/FilterExtension.php
@@ -21,8 +21,6 @@
 /**
  * Applies filters on a resource aggregation.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Samuel ROZE <samuel.roze@gmail.com>
  */
diff --git a/src/Doctrine/Odm/Extension/OrderExtension.php b/src/Doctrine/Odm/Extension/OrderExtension.php
@@ -24,8 +24,6 @@
 /**
  * Applies selected ordering while querying resource collection.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Samuel ROZE <samuel.roze@gmail.com>
  * @author Vincent Chalamon <vincentchalamon@gmail.com>
diff --git a/src/Doctrine/Odm/Extension/PaginationExtension.php b/src/Doctrine/Odm/Extension/PaginationExtension.php
@@ -25,8 +25,6 @@
 /**
  * Applies pagination on the Doctrine aggregation for resource collection when enabled.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Samuel ROZE <samuel.roze@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
diff --git a/src/Doctrine/Odm/Filter/AbstractFilter.php b/src/Doctrine/Odm/Filter/AbstractFilter.php
@@ -27,8 +27,6 @@
  *
  * Abstract class for easing the implementation of a filter.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 abstract class AbstractFilter implements FilterInterface
diff --git a/src/Doctrine/Odm/Filter/BooleanFilter.php b/src/Doctrine/Odm/Filter/BooleanFilter.php
@@ -27,8 +27,6 @@
  * For each property passed, if the resource does not have such property or if
  * the value is not one of ( "true" | "false" | "1" | "0" ) the property is ignored.
  *
- * @experimental
- *
  * @author Amrouche Hamza <hamza.simperfit@gmail.com>
  * @author Teoh Han Hui <teohhanhui@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
diff --git a/src/Doctrine/Odm/Filter/DateFilter.php b/src/Doctrine/Odm/Filter/DateFilter.php
@@ -23,8 +23,6 @@
 /**
  * Filters the collection by date intervals.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Théo FIDRY <theo.fidry@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
diff --git a/src/Doctrine/Odm/Filter/ExistsFilter.php b/src/Doctrine/Odm/Filter/ExistsFilter.php
@@ -32,8 +32,6 @@
  * Request: GET /products?exists[brand]
  * Interpretation: filter products which have a brand
  *
- * @experimental
- *
  * @author Teoh Han Hui <teohhanhui@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Doctrine/Odm/Filter/FilterInterface.php b/src/Doctrine/Odm/Filter/FilterInterface.php
@@ -20,8 +20,6 @@
 /**
  * Doctrine MongoDB ODM filter interface.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 interface FilterInterface extends BaseFilterInterface
diff --git a/src/Doctrine/Odm/Filter/NumericFilter.php b/src/Doctrine/Odm/Filter/NumericFilter.php
@@ -26,8 +26,6 @@
  * For each property passed, if the resource does not have such property or if
  * the value is not numeric, the property is ignored.
  *
- * @experimental
- *
  * @author Amrouche Hamza <hamza.simperfit@gmail.com>
  * @author Teoh Han Hui <teohhanhui@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
diff --git a/src/Doctrine/Odm/Filter/OrderFilter.php b/src/Doctrine/Odm/Filter/OrderFilter.php
@@ -31,8 +31,6 @@
  * direction value is different from "asc" or "desc" (case insensitive), the property
  * is ignored.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Théo FIDRY <theo.fidry@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
diff --git a/src/Doctrine/Odm/Filter/RangeFilter.php b/src/Doctrine/Odm/Filter/RangeFilter.php
@@ -21,8 +21,6 @@
 /**
  * Filters the collection by range.
  *
- * @experimental
- *
  * @author Lee Siong Chan <ahlee2326@me.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Doctrine/Odm/Filter/SearchFilter.php b/src/Doctrine/Odm/Filter/SearchFilter.php
@@ -32,8 +32,6 @@
 /**
  * Filter the collection by given properties.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Doctrine/Odm/Metadata/Property/DoctrineMongoDbOdmPropertyMetadataFactory.php b/src/Doctrine/Odm/Metadata/Property/DoctrineMongoDbOdmPropertyMetadataFactory.php
@@ -21,8 +21,6 @@
 /**
  * Use Doctrine metadata to populate the identifier property.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Doctrine/Odm/Paginator.php b/src/Doctrine/Odm/Paginator.php
@@ -21,8 +21,6 @@
 /**
  * Decorates the Doctrine MongoDB ODM paginator.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Doctrine/Odm/PropertyHelperTrait.php b/src/Doctrine/Odm/PropertyHelperTrait.php
@@ -22,8 +22,6 @@
 /**
  * Helper trait regarding a property in a MongoDB document using the resource metadata.
  *
- * @experimental
- *
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
 trait PropertyHelperTrait
diff --git a/src/Doctrine/Odm/PropertyInfo/DoctrineExtractor.php b/src/Doctrine/Odm/PropertyInfo/DoctrineExtractor.php
@@ -27,8 +27,6 @@
 /**
  * Extracts data using Doctrine MongoDB ODM metadata.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Alan Poulain <contact@alanpoulain.eu>
  */
diff --git a/src/Elasticsearch/Filter/MatchFilter.php b/src/Elasticsearch/Filter/MatchFilter.php
@@ -18,8 +18,6 @@
  *
  * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-match-query.html
  *
- * @experimental
- *
  * @author Baptiste Meyer <baptiste.meyer@gmail.com>
  */
 final class MatchFilter extends AbstractSearchFilter
diff --git a/src/Hal/JsonSchema/SchemaFactory.php b/src/Hal/JsonSchema/SchemaFactory.php
@@ -20,8 +20,6 @@
 /**
  * Decorator factory which adds HAL properties to the JSON Schema document.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  * @author Jachim Coudenys <jachimcoudenys@gmail.com>
  */
diff --git a/src/HttpCache/EventListener/AddHeadersListener.php b/src/HttpCache/EventListener/AddHeadersListener.php
@@ -23,8 +23,6 @@
  * Configures cache HTTP headers for the current response.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class AddHeadersListener
 {
diff --git a/src/HttpCache/EventListener/AddTagsListener.php b/src/HttpCache/EventListener/AddTagsListener.php
@@ -36,8 +36,6 @@
  * @see https://docs.varnish-software.com/varnish-cache-plus/vmods/ykey/
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class AddTagsListener
 {
diff --git a/src/HttpCache/PurgerInterface.php b/src/HttpCache/PurgerInterface.php
@@ -17,8 +17,6 @@
  * Purges resources from the cache.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 interface PurgerInterface
 {
diff --git a/src/HttpCache/VarnishPurger.php b/src/HttpCache/VarnishPurger.php
@@ -19,8 +19,6 @@
  * Purges Varnish.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class VarnishPurger implements PurgerInterface
 {
diff --git a/src/HttpCache/VarnishXKeyPurger.php b/src/HttpCache/VarnishXKeyPurger.php
@@ -19,8 +19,6 @@
  * Purges Varnish XKey.
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class VarnishXKeyPurger implements PurgerInterface
 {
diff --git a/src/Hydra/JsonSchema/SchemaFactory.php b/src/Hydra/JsonSchema/SchemaFactory.php
@@ -22,8 +22,6 @@
 /**
  * Decorator factory which adds Hydra properties to the JSON Schema document.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 final class SchemaFactory implements SchemaFactoryInterface
diff --git a/src/JsonSchema/Schema.php b/src/JsonSchema/Schema.php
@@ -21,8 +21,6 @@
  * @see https://json-schema.org/latest/json-schema-core.html
  * @see https://github.com/OAI/OpenAPI-Specification
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 final class Schema extends \ArrayObject
diff --git a/src/JsonSchema/SchemaFactory.php b/src/JsonSchema/SchemaFactory.php
@@ -30,8 +30,6 @@
 /**
  * {@inheritdoc}
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 final class SchemaFactory implements SchemaFactoryInterface
diff --git a/src/JsonSchema/SchemaFactoryInterface.php b/src/JsonSchema/SchemaFactoryInterface.php
@@ -18,8 +18,6 @@
 /**
  * Factory for creating the JSON Schema document corresponding to a PHP class.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 interface SchemaFactoryInterface
diff --git a/src/JsonSchema/TypeFactory.php b/src/JsonSchema/TypeFactory.php
@@ -24,8 +24,6 @@
 /**
  * {@inheritdoc}
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 final class TypeFactory implements TypeFactoryInterface
diff --git a/src/JsonSchema/TypeFactoryInterface.php b/src/JsonSchema/TypeFactoryInterface.php
@@ -18,8 +18,6 @@
 /**
  * Factory for creating the JSON Schema document which specifies the data type corresponding to a PHP type.
  *
- * @experimental
- *
  * @author Kévin Dunglas <dunglas@gmail.com>
  */
 interface TypeFactoryInterface
diff --git a/src/Metadata/ApiResource.php b/src/Metadata/ApiResource.php
@@ -19,8 +19,6 @@
  * Resource metadata attribute.
  *
  * @author Antoine Bluchet <soyuka@gmail.com>
- *
- * @experimental
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
 class ApiResource
diff --git a/src/Metadata/NotExposed.php b/src/Metadata/NotExposed.php
@@ -18,7 +18,7 @@
  * for example to generate an IRI on a resource without item operations.
  * It is ignored from OpenApi documentation and must return a HTTP 404.
  *
- * @internal
+ * @author Vincent Chalamon <vincentchalamon@gmail.com>
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
 final class NotExposed extends HttpOperation
diff --git a/src/Metadata/Resource/Factory/AlternateUriResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/AlternateUriResourceMetadataCollectionFactory.php
@@ -18,7 +18,7 @@
 /**
  * @author Antoine Bluchet <soyuka@gmail.com>
  *
- * @experimental
+ * @deprecated BC layer, is removed in 3.0
  */
 final class AlternateUriResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Metadata/Resource/Factory/AttributesResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/AttributesResourceMetadataCollectionFactory.php
@@ -41,8 +41,6 @@
  * Creates a resource metadata from {@see ApiResource} annotations.
  *
  * @author Antoine Bluchet <soyuka@gmail.com>
- *
- * @experimental
  */
 final class AttributesResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Metadata/Resource/Factory/ExtractorResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/ExtractorResourceMetadataCollectionFactory.php
@@ -31,8 +31,6 @@
  * Creates a resource metadata from {@see Resource} extractors (XML, YAML).
  *
  * @author Vincent Chalamon <vincentchalamon@gmail.com>
- *
- * @experimental
  */
 final class ExtractorResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Metadata/Resource/Factory/FiltersResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/FiltersResourceMetadataCollectionFactory.php
@@ -22,8 +22,6 @@
  * Creates a resource metadata from {@see Resource} annotations.
  *
  * @author Antoine Bluchet <soyuka@gmail.com>
- *
- * @experimental
  */
 final class FiltersResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Metadata/Resource/Factory/FormatsResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/FormatsResourceMetadataCollectionFactory.php
@@ -30,8 +30,6 @@
  *       * operation input/output formats
  *
  * @author Kévin Dunglas <dunglas@gmail.com>
- *
- * @experimental
  */
 final class FormatsResourceMetadataCollectionFactory implements ResourceMetadataCollectionFactoryInterface
 {
diff --git a/src/Metadata/Resource/Factory/InputOutputResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/InputOutputResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/Factory/LinkResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/LinkResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/Factory/NotExposedOperationResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/NotExposedOperationResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/Factory/OperationNameResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/OperationNameResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/Factory/PhpDocResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/PhpDocResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/Factory/ResourceMetadataCollectionFactoryInterface.php b/src/Metadata/Resource/Factory/ResourceMetadataCollectionFactoryInterface.php
diff --git a/src/Metadata/Resource/Factory/UriTemplateResourceMetadataCollectionFactory.php b/src/Metadata/Resource/Factory/UriTemplateResourceMetadataCollectionFactory.php
diff --git a/src/Metadata/Resource/ResourceMetadataCollection.php b/src/Metadata/Resource/ResourceMetadataCollection.php
diff --git a/src/State/ProcessorInterface.php b/src/State/ProcessorInterface.php
diff --git a/src/State/ProviderInterface.php b/src/State/ProviderInterface.php
diff --git a/src/State/UriVariablesResolverTrait.php b/src/State/UriVariablesResolverTrait.php
diff --git a/src/Symfony/Bundle/Test/ApiTestAssertionsTrait.php b/src/Symfony/Bundle/Test/ApiTestAssertionsTrait.php
diff --git a/src/Symfony/Bundle/Test/ApiTestCase.php b/src/Symfony/Bundle/Test/ApiTestCase.php
diff --git a/src/Symfony/Bundle/Test/Client.php b/src/Symfony/Bundle/Test/Client.php
diff --git a/src/Symfony/Bundle/Test/Constraint/MatchesJsonSchema.php b/src/Symfony/Bundle/Test/Constraint/MatchesJsonSchema.php
diff --git a/src/Symfony/Messenger/ContextStamp.php b/src/Symfony/Messenger/ContextStamp.php
diff --git a/src/Symfony/Messenger/RemoveStamp.php b/src/Symfony/Messenger/RemoveStamp.php
diff --git a/src/Symfony/Routing/IriConverter.php b/src/Symfony/Routing/IriConverter.php
diff --git a/src/Symfony/Routing/SkolemIriConverter.php b/src/Symfony/Routing/SkolemIriConverter.php

Original file line number	Diff line number	Diff line change
`@@ -37,8 +37,6 @@`
`37`	`37`	`* Publishes resources updates to the Mercure hub.`
`38`	`38`	`*`
`39`	`39`	`* @author Kévin Dunglas <[email protected]>`
`40`		`- *`
`41`		`- * @experimental`
`42`	`40`	`*/`
`43`	`41`	`final class PublishMercureUpdatesListener`
`44`	`42`	`{`
Original file line number	Diff line number	Diff line change
`@@ -39,8 +39,6 @@`
`39`	`39`	`* Publishes resources updates to the Mercure hub.`
`40`	`40`	`*`
`41`	`41`	`* @author Kévin Dunglas <[email protected]>`
`42`		`- *`
`43`		`- * @experimental`
`44`	`42`	`*/`
`45`	`43`	`final class PublishMercureUpdatesListener`
`46`	`44`	`{`
Original file line number	Diff line number	Diff line change
`@@ -35,8 +35,6 @@`
`35`	`35`	`* Purges responses containing modified entities from the proxy cache.`
`36`	`36`	`*`
`37`	`37`	`* @author Kévin Dunglas <[email protected]>`
`38`		`- *`
`39`		`- * @experimental`
`40`	`38`	`*/`
`41`	`39`	`final class PurgeHttpCacheListener`
`42`	`40`	`{`
Original file line number	Diff line number	Diff line change
`@@ -19,8 +19,6 @@`
`19`	`19`	`/**`
`20`	`20`	`* Interface of Doctrine MongoDB ODM aggregation extensions for collection aggregations.`
`21`	`21`	`*`
`22`		`- * @experimental`
`23`		`- *`
`24`	`22`	`* @author Alan Poulain <[email protected]>`
`25`	`23`	`*/`
`26`	`24`	`interface AggregationCollectionExtensionInterface`
Original file line number	Diff line number	Diff line change
`@@ -20,8 +20,6 @@`
`20`	`20`	`* Interface of Doctrine MongoDB ODM aggregation extensions that supports result production`
`21`	`21`	`* for specific cases such as pagination.`
`22`	`22`	`*`
`23`		`- * @experimental`
`24`		`- *`
`25`	`23`	`* @author Alan Poulain <[email protected]>`
`26`	`24`	`*/`
`27`	`25`	`interface AggregationResultCollectionExtensionInterface extends AggregationCollectionExtensionInterface`
Original file line number	Diff line number	Diff line change
`@@ -21,8 +21,6 @@`
`21`	`21`	`/**`
`22`	`22`	`* Applies filters on a resource aggregation.`
`23`	`23`	`*`
`24`		`- * @experimental`
`25`		`- *`
`26`	`24`	`* @author Kévin Dunglas <[email protected]>`
`27`	`25`	`* @author Samuel ROZE <[email protected]>`
`28`	`26`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -24,8 +24,6 @@`
`24`	`24`	`/**`
`25`	`25`	`* Applies selected ordering while querying resource collection.`
`26`	`26`	`*`
`27`		`- * @experimental`
`28`		`- *`
`29`	`27`	`* @author Kévin Dunglas <[email protected]>`
`30`	`28`	`* @author Samuel ROZE <[email protected]>`
`31`	`29`	`* @author Vincent Chalamon <[email protected]>`