[Contracts] fine tune composer.json declarations for suggest/provide

Author: nicolas-grekas

Cache/CacheInterface.php

@@ -25,6 +25,7 @@
 interface CacheInterface
 {
     /**
+     * @param string                        $key      The key of the item to retrieve from the cache
      * @param callable(ItemInterface):mixed $callback Should return the computed value for the given key/item
      * @param float|null                    $beta     A float that, as it grows, controls the likeliness of triggering
      *                                                early expiration. 0 disables it, INF forces immediate expiration.

README.md

@@ -16,8 +16,8 @@ Design Principles
  * they must be backward compatible with existing Symfony components.
 
 Packages that implement specific contracts should list them in the "provide"
-section of their "composer.json" file, using the `symfony/*-contracts`
-convention (e.g. `"provide": { "symfony/cache-contracts": "1.0" }`).
+section of their "composer.json" file, using the `symfony/*-contracts-implementation`
+convention (e.g. `"provide": { "symfony/cache-contracts-implementation": "1.0" }`).
 
 FAQ
 ---

composer.json

@@ -24,7 +24,10 @@
     },
     "suggest": {
         "psr/cache": "When using the Cache contracts",
-        "psr/container": "When using the Service contracts"
+        "psr/container": "When using the Service contracts",
+        "symfony/cache-contracts-implementation": "",
+        "symfony/service-contracts-implementation": "",
+        "symfony/translation-contracts-implementation": ""
     },
     "autoload": {
         "psr-4": { "Symfony\\Contracts\\": "" },