diff --git a/lib/private/Files/Cache/StorageGlobal.php b/lib/private/Files/Cache/StorageGlobal.php
index 87116702d3a..b7d128d00a0 100644
--- a/lib/private/Files/Cache/StorageGlobal.php
+++ b/lib/private/Files/Cache/StorageGlobal.php
@@ -12,15 +12,14 @@ use OCP\DB\QueryBuilder\IQueryBuilder;
 use OCP\IDBConnection;
 
 /**
- * Handle the mapping between the string and numeric storage ids
+ * Provides a process-local cache of persisted storage-id mappings.
  *
- * Each storage has 2 different ids
- *    a string id which is generated by the storage backend and reflects the configuration of the storage (e.g. 'smb://user@host/share')
- *    and a numeric storage id which is referenced in the file cache
+ * Caches lookups in both directions:
+ * - string storage id to storage record
+ * - numeric storage id to storage record
  *
- * A mapping between the two storage ids is stored in the database and accessible through this class
- *
- * @package OC\Files\Cache
+ * This class reduces repeated database lookups for storage mapping metadata
+ * and provides invalidation helpers for callers that update those records.
  */
 class StorageGlobal {
 	/** @var array<string, array{id: string, numeric_id: int, available: bool, last_checked: int}> */