diff --git a/core/lib/Drupal/Core/Config/Config.php b/core/lib/Drupal/Core/Config/Config.php index 51880a2..7ad1aee 100644 --- a/core/lib/Drupal/Core/Config/Config.php +++ b/core/lib/Drupal/Core/Config/Config.php @@ -20,7 +20,7 @@ * Defines the default configuration object. * * Encapsulates all capabilities needed for configuration handling for a - * specific configuration name including support for runtime overrides. The + * specific configuration object, including support for runtime overrides. The * overrides are handled on top of the stored configuration so they are not * saved back to storage. */ diff --git a/core/lib/Drupal/Core/Config/ConfigBase.php b/core/lib/Drupal/Core/Config/ConfigBase.php index 1df19aa..8dfac43 100644 --- a/core/lib/Drupal/Core/Config/ConfigBase.php +++ b/core/lib/Drupal/Core/Config/ConfigBase.php @@ -15,11 +15,15 @@ * Provides a base class for configuration objects with get/set support. * * Encapsulates all capabilities needed for runtime configuration handling for - * a specific configuration name. Extend from this class for non-storable - * configuration where the configuration API is desired but storage is not - * possible. For example, if the data is derived at runtime. + * a specific configuration object. + * + * Extend directly from this class for non-storable configuration where the + * configuration API is desired but storage is not possible; for example, if + * the data is derived at runtime. For storable configuration, extend + * \Drupal\Core\Config\StorableConfigBase. * * @see \Drupal\Core\Config\StorableConfigBase + * @see \Drupal\Core\Config\Config * @see \Drupal\Core\Theme\ThemeSettings */ abstract class ConfigBase extends DependencySerialization { diff --git a/core/lib/Drupal/Core/Config/StorableConfigBase.php b/core/lib/Drupal/Core/Config/StorableConfigBase.php index f1e43a3..8aa292b 100644 --- a/core/lib/Drupal/Core/Config/StorableConfigBase.php +++ b/core/lib/Drupal/Core/Config/StorableConfigBase.php @@ -17,9 +17,11 @@ * Provides a base class for configuration objects with storage support. * * Encapsulates all capabilities needed for configuration handling for a - * specific configuration name including storage and data type casting. Extend - * from StorableConfigBase to manage configuration with a storage backend that - * does not support overrides. + * specific configuration object, including storage and data type casting. + * + * The default implementation in \Drupal\Core\Config\Config adds support for + * runtime overrides. Extend from StorableConfigBase directly to manage + * configuration with a storage backend that does not support overrides. * * @see \Drupal\Core\Config\Config */