diff --git a/core/lib/Drupal/Core/Display/Annotation/DisplayVariant.php b/core/lib/Drupal/Core/Display/Annotation/DisplayVariant.php
index 08817a1..dd5a132 100644
--- a/core/lib/Drupal/Core/Display/Annotation/DisplayVariant.php
+++ b/core/lib/Drupal/Core/Display/Annotation/DisplayVariant.php
@@ -23,10 +23,17 @@
  * object.
  *
  * @todo: Revise description when/if Displays are added to core:
- * https://www.drupal.org/node/2292733 
+ *   https://www.drupal.org/node/2292733
+ *
+ * Plugin namespace: Plugin\DisplayVariant
+ *
+ * For a working example, see
+ * \Drupal\block\Plugin\DisplayVariant\FullPageVariant
  *
  * @see \Drupal\Core\Display\VariantInterface
+ * @see \Drupal\Core\Display\VariantBase
  * @see \Drupal\Core\Display\VariantManager
+ * @see plugin_api
  *
  * @Annotation
  */
diff --git a/core/lib/Drupal/Core/Display/VariantBase.php b/core/lib/Drupal/Core/Display/VariantBase.php
index eba349b..c4c8c65 100644
--- a/core/lib/Drupal/Core/Display/VariantBase.php
+++ b/core/lib/Drupal/Core/Display/VariantBase.php
@@ -14,6 +14,11 @@
 
 /**
  * Provides a base class for DisplayVariant plugins.
+ *
+ * @see \Drupal\Core\Display\Annotation\DisplayVariant
+ * @see \Drupal\Core\Display\VariantInterface
+ * @see \Drupal\Core\Display\VariantManager
+ * @see plugin_api
  */
 abstract class VariantBase extends PluginBase implements VariantInterface {
 
diff --git a/core/lib/Drupal/Core/Display/VariantInterface.php b/core/lib/Drupal/Core/Display/VariantInterface.php
index 780b47a..8561b6a 100644
--- a/core/lib/Drupal/Core/Display/VariantInterface.php
+++ b/core/lib/Drupal/Core/Display/VariantInterface.php
@@ -16,7 +16,9 @@
  * Provides an interface for DisplayVariant plugins.
  *
  * @see \Drupal\Core\Display\Annotation\DisplayVariant
+ * @see \Drupal\Core\Display\VariantBase
  * @see \Drupal\Core\Display\VariantManager
+ * @see plugin_api
  */
 interface VariantInterface extends PluginInspectionInterface, ConfigurablePluginInterface, PluginFormInterface {
 
diff --git a/core/lib/Drupal/Core/Display/VariantManager.php b/core/lib/Drupal/Core/Display/VariantManager.php
index 7f18a29..0b3d333 100755
--- a/core/lib/Drupal/Core/Display/VariantManager.php
+++ b/core/lib/Drupal/Core/Display/VariantManager.php
@@ -16,6 +16,8 @@
  *
  * @see \Drupal\Core\Display\Annotation\DisplayVariant
  * @see \Drupal\Core\Display\VariantInterface
+ * @see \Drupal\Core\Display\VariantBase
+ * @see plugin_api
  */
 class VariantManager extends DefaultPluginManager {