diff -u b/core/modules/entity_reference/src/Annotation/EntityReferenceSelection.php b/core/modules/entity_reference/src/Annotation/EntityReferenceSelection.php
--- b/core/modules/entity_reference/src/Annotation/EntityReferenceSelection.php
+++ b/core/modules/entity_reference/src/Annotation/EntityReferenceSelection.php
@@ -10,11 +10,12 @@
 use Drupal\Component\Annotation\Plugin;
 
 /**
- * Defines a EntityReferenceSelection annotation object.
+ * Defines an EntityReferenceSelection plugin annotation object.
  *
  * Plugin Namespace: Plugin\entity_reference\selection
  *
- * For a working example, see \Drupal\comment\Plugin\entity_reference\selection\CommentSelection
+ * For a working example, see
+ * \Drupal\comment\Plugin\entity_reference\selection\CommentSelection
  *
  * @see \Drupal\entity_reference\Plugin\Type\SelectionPluginManager
  * @see \Drupal\entity_reference\Plugin\Type\Selection\SelectionInterface
diff -u b/core/modules/entity_reference/src/Plugin/Type/Selection/SelectionInterface.php b/core/modules/entity_reference/src/Plugin/Type/Selection/SelectionInterface.php
--- b/core/modules/entity_reference/src/Plugin/Type/Selection/SelectionInterface.php
+++ b/core/modules/entity_reference/src/Plugin/Type/Selection/SelectionInterface.php
@@ -11,13 +11,9 @@
 use Drupal\Core\Field\FieldDefinitionInterface;
 
 /**
- * Interface definition for Entity Reference selection plugins.
- *
- * This interface details the methods that most plugin implementations will want
- * to override. See \Drupal\field\Plugin\Type\Selection\SelectionBaseInterface
- * for base wrapping methods that should most likely be inherited directly from
- * \Drupal\entity_reference\Plugin\entity_reference\selection\SelectionBase.
+ * Interface definition for Entity Reference Selection plugins.
  *
+ * @see \Drupal\entity_reference\Plugin\entity_reference\selection\SelectionBase
  * @see \Drupal\entity_reference\Plugin\Type\SelectionPluginManager
  * @see \Drupal\entity_reference\Annotation\EntityReferenceSelection
  * @see plugin_api
diff -u b/core/modules/entity_reference/src/Plugin/Type/SelectionPluginManager.php b/core/modules/entity_reference/src/Plugin/Type/SelectionPluginManager.php
--- b/core/modules/entity_reference/src/Plugin/Type/SelectionPluginManager.php
+++ b/core/modules/entity_reference/src/Plugin/Type/SelectionPluginManager.php
@@ -18,7 +18,7 @@
 use Drupal\entity_reference\Plugin\Type\Selection\SelectionBroken;
 
 /**
- * Plugin type manager for the Entity Reference Selection plugin.
+ * Plugin type manager for Entity Reference Selection plugins.
  *
  * @see \Drupal\entity_reference\Annotation\EntityReferenceSelection
  * @see \Drupal\entity_reference\Plugin\Type\Selection\SelectionInterface
diff -u b/core/modules/entity_reference/src/Plugin/entity_reference/selection/SelectionBase.php b/core/modules/entity_reference/src/Plugin/entity_reference/selection/SelectionBase.php
--- b/core/modules/entity_reference/src/Plugin/entity_reference/selection/SelectionBase.php
+++ b/core/modules/entity_reference/src/Plugin/entity_reference/selection/SelectionBase.php
@@ -15,7 +15,16 @@
 use Drupal\entity_reference\Plugin\Type\Selection\SelectionInterface;
 
 /**
- * Plugin implementation of the 'selection' entity_reference.
+ * Default plugin implementation of the Entity Reference Selection plugin.
+ *
+ * Also serves as a base class for specific types of entity reference
+ * selection plugins.
+ *
+ * @see \Drupal\entity_reference\Plugin\Type\SelectionPluginManager
+ * @see \Drupal\entity_reference\Annotation\EntityReferenceSelection
+ * @see \Drupal\entity_reference\Plugin\Type\Selection\SelectionInterface
+ * @see \Drupal\entity_reference\Plugin\Derivative\SelectionBase
+ * @see plugin_api
  *
  * @EntityReferenceSelection(
  *   id = "default",
@@ -24,11 +33,6 @@
  *   weight = 0,
  *   derivative = "Drupal\entity_reference\Plugin\Derivative\SelectionBase"
  * )
- *
- * @see \Drupal\entity_reference\Plugin\Type\SelectionPluginManager
- * @see \Drupal\entity_reference\Annotation\EntityReferenceSelection
- * @see \Drupal\entity_reference\Plugin\Type\Selection\SelectionInterface
- * @see plugin_api
  */
 class SelectionBase implements SelectionInterface {
 
only in patch2:
unchanged:
--- a/core/modules/entity_reference/src/Plugin/Derivative/SelectionBase.php
+++ b/core/modules/entity_reference/src/Plugin/Derivative/SelectionBase.php
@@ -10,7 +10,7 @@
 use Drupal\Component\Plugin\Derivative\DerivativeBase;
 
 /**
- * Base class for selection plugins provided by Entity Reference.
+ * Provides derivative plugins for Entity Reference Selection plugins.
  */
 class SelectionBase extends DerivativeBase {
   /**