improve documented scope return values

TC review suggests that DETACHED and INACTIVE responses need clarification
open-telemetry · Jun 6, 2023 · a5966d5 · a5966d5
1 parent 1b63a3b
commit a5966d5
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 4 deletions.
diff --git a/src/Context/Context.php b/src/Context/Context.php
@@ -53,7 +53,7 @@ public static function storage(): ContextStorageInterface
     /**
      * @param ContextInterface|false|null $context
      *
-     * @internal
+     * @internal OpenTelemetry
      */
     public static function resolve($context, ?ContextStorageInterface $contextStorage = null): ContextInterface
     {

diff --git a/src/Context/ScopeInterface.php b/src/Context/ScopeInterface.php
@@ -8,11 +8,11 @@
 
 interface ScopeInterface
 {
-    /** Already detached. */
+    /** The associated context was already detached. */
     public const DETACHED = 1 << (PHP_INT_SIZE << 3) - 1;
-    /** Execution context inactive. */
+    /** The associated context is not in the active execution context. */
     public const INACTIVE = 1 << (PHP_INT_SIZE << 3) - 2;
-    /** Not current context. */
+    /** The associated context is not the active context. */
     public const MISMATCH = 1 << (PHP_INT_SIZE << 3) - 3;
 
     /**