diff --git a/core/lib/Drupal/Core/Plugin/Discovery/YamlDiscoveryDecorator.php b/core/lib/Drupal/Core/Plugin/Discovery/YamlDiscoveryDecorator.php
index 8518c6b..2957dc0 100644
--- a/core/lib/Drupal/Core/Plugin/Discovery/YamlDiscoveryDecorator.php
+++ b/core/lib/Drupal/Core/Plugin/Discovery/YamlDiscoveryDecorator.php
@@ -12,8 +12,8 @@
 /**
  * Enables YAML discovery for plugin definitions.
  *
- * You probably want to extend this class to add new validation like restrict
- * people from specifying the class key directly and rather use annotations.
+ * You should normally extend this class to add validation for the values in the
+ * YAML data or to restrict use of the class or derivatives keys.
  */
 class YamlDiscoveryDecorator extends YamlDiscovery {