diff --git a/core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php b/core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php index a829cec432b8da36ff37bee97322859cb3083175..c18a704081ea598d1aff4d9d869fa7c95cc5ef24 100644 --- a/core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php +++ b/core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php @@ -3,7 +3,9 @@ namespace Drupal\Component\Plugin\Context; /** - * Interface for context definitions. + * Interface used to define definition objects found in ContextInterface. + * + * @see \Drupal\Component\Plugin\Context\ContextInterface * * @todo WARNING: This interface is going to receive some additions as part of * https://www.drupal.org/node/2346999. diff --git a/core/lib/Drupal/Component/Plugin/Context/ContextInterface.php b/core/lib/Drupal/Component/Plugin/Context/ContextInterface.php index 9b7134f95f8d6fcac1cd111eb38b08cfc29a58dd..605c6587bc478cdc1523356ad7ffebb4f8c5a279 100644 --- a/core/lib/Drupal/Component/Plugin/Context/ContextInterface.php +++ b/core/lib/Drupal/Component/Plugin/Context/ContextInterface.php @@ -3,7 +3,14 @@ namespace Drupal\Component\Plugin\Context; /** - * A generic context interface for wrapping data a plugin needs to operate. + * Provides data and definitions for plugins during runtime and administration. + * + * Plugin contexts are satisfied by ContextInterface implementing objects. + * These objects always contain a definition of what data they will provide + * during runtime. During run time, ContextInterface implementing objects must + * also provide the corresponding data value. + * + * @see \Drupal\Component\Plugin\Context\ContextDefinitionInterface */ interface ContextInterface { diff --git a/core/lib/Drupal/Core/Plugin/Context/ContextDefinitionInterface.php b/core/lib/Drupal/Core/Plugin/Context/ContextDefinitionInterface.php index 8cd07208a61e54a415f90ffe5282328c1a4fadda..c60c6c7fcb6533e6475d4c5e685de00128739caf 100644 --- a/core/lib/Drupal/Core/Plugin/Context/ContextDefinitionInterface.php +++ b/core/lib/Drupal/Core/Plugin/Context/ContextDefinitionInterface.php @@ -5,7 +5,10 @@ use Drupal\Component\Plugin\Context\ContextDefinitionInterface as ComponentContextDefinitionInterface; /** - * Interface for context definitions. + * Interface to define definition objects in ContextInterface via TypedData. + * + * @see \Drupal\Component\Plugin\Context\ContextDefinitionInterface + * @see \Drupal\Core\Plugin\Context\ContextInterface */ interface ContextDefinitionInterface extends ComponentContextDefinitionInterface { diff --git a/core/lib/Drupal/Core/Plugin/Context/ContextInterface.php b/core/lib/Drupal/Core/Plugin/Context/ContextInterface.php index d126886e31844772cddbde1dbf83c581189db95d..260cb2c33d25d8938adb507493b72eaaf0303c69 100644 --- a/core/lib/Drupal/Core/Plugin/Context/ContextInterface.php +++ b/core/lib/Drupal/Core/Plugin/Context/ContextInterface.php @@ -6,7 +6,10 @@ use Drupal\Core\Cache\CacheableDependencyInterface; /** - * Interface for context. + * Context data and definitions for plugins supporting caching and return docs. + * + * @see \Drupal\Component\Plugin\Context\ContextInterface + * @see \Drupal\Core\Plugin\Context\ContextDefinitionInterface */ interface ContextInterface extends ComponentContextInterface, CacheableDependencyInterface {