Issue #3367151 by marvil07, Anchal_gupta, xjm, smustgrave, larowlan, longwave,...

Issue #3367151 by marvil07, Anchal_gupta, xjm, smustgrave, larowlan, longwave, dpi: Docs on return type on two media constraints are misleading

core/modules/media/src/MediaSourceEntityConstraintsInterface.php

@@ -20,7 +20,8 @@ interface MediaSourceEntityConstraintsInterface extends MediaSourceInterface {
    * Gets media source-specific validation constraints for a media item.
    *
    * @return \Symfony\Component\Validator\Constraint[]
-   *   An array of validation constraint definitions, keyed by constraint name.
+   *   An array of validation constraint definitions, keyed by plugin IDs. The
+   *   corresponding values are options for each validation plugin.
    *   Each constraint definition can be used for instantiating
    *   \Symfony\Component\Validator\Constraint objects.
    */

core/modules/media/src/MediaSourceFieldConstraintsInterface.php

@@ -20,7 +20,8 @@ interface MediaSourceFieldConstraintsInterface extends MediaSourceInterface {
    * Gets media source-specific validation constraints for a source field.
    *
    * @return \Symfony\Component\Validator\Constraint[]
-   *   An array of validation constraint definitions, keyed by constraint name.
+   *   An array of validation constraint definitions, keyed by plugin IDs. The
+   *   corresponding values are options for each validation plugin.
    *   Each constraint definition can be used for instantiating
    *   \Symfony\Component\Validator\Constraint objects.
    */