From 2bf5a834261afa9bf0bcdbf2a4939f4f64b65085 Mon Sep 17 00:00:00 2001
From: brabli <67018167+brabli@users.noreply.github.com>
Date: Thu, 27 Nov 2025 14:55:01 +0000
Subject: [PATCH] Adjust docblocks

---
 src/Interface/MetadataInterface.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Interface/MetadataInterface.php b/src/Interface/MetadataInterface.php
index 45cb73a..5e097a4 100644
--- a/src/Interface/MetadataInterface.php
+++ b/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;
 }
 
-
-