Adjust docblocks

src/Interface/MetadataInterface.php

@@ -9,7 +9,7 @@ use Pcm\MetadataBundle\Exception\MissingKeyException;
 interface MetadataInterface
 {
     /**
-     * Retrieve a value by it's key.
+     * Retrieve a value from the metadata by it's key.
      *
      * @return scalar|scalar[]
      *
@@ -18,18 +18,18 @@ interface MetadataInterface
     public function get(string $key): mixed;
 
     /**
-     * Sets a value against the given key. This overwrites
-     * any existing value.
+     * Sets a value against the given key.
+     * If this key is already set, it's value will be overwritten.
      *
      * @param scalar|scalar[] $value
      */
     public function set(string $key, mixed $value): static;
 
     /**
-     * Whether a key has been set on the metadata.
+     * Whether a key is set on the metadata.
+     *
+     * @return bool `true` if the key is set (regardless of what the value is), otherwise `false`.
      */
     public function has(string $key): bool;
 }
 
-
-