diff --git a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php
index 9fb3ad5..6f314eb 100644
--- a/core/lib/Drupal/Core/Plugin/PluginFormInterface.php
+++ b/core/lib/Drupal/Core/Plugin/PluginFormInterface.php
@@ -10,18 +10,22 @@
 use Drupal\Core\Form\FormStateInterface;
 
 /**
- * Provides an interface for a plugin that contains a form.
+ * Provides an interface for a plugin that contains a embeddable form.
  *
- * Plugin forms are usually contained in other forms. In order to know where the
- * plugin form is located in the parent form, #parents and #array_parents must
- * be known, but these are not available during the initial build phase. In
- * order to have these properties available when building the plugin form's
- * elements, let buildConfigurationForm() return a form element that has a
- * #process callback and build the rest of the form in the callback. By the time
- * the callback is executed, the element's #parents and #array_parents
- * properties will have been set by the form API. For more documentation on
- * #parents and #array_parents, see
+ * Plugin forms are embedded in other forms. In order to know where the plugin
+ * form is located in the parent form, #parents and #array_parents must be
+ * known, but these are not available during the initial build phase. In order
+ * to have these properties available when building the plugin form's elements,
+ * let buildConfigurationForm() return a form element that has a #process
+ * callback and build the rest of the form in the callback. By the time the
+ * callback is executed, the element's #parents and #array_parents properties
+ * will have been set by the form API. For more documentation on #parents and
+ * #array_parents, see
  * https://api.drupal.org/api/drupal/developer!topics!forms_api_reference.html/8.
+ * During validation and submission, the plugin form's elements' #parents and
+ * #array_parents properties have already been populated and can be used
+ * directly to find the location of the submitted form values in the form's
+ * state.
  *
  * @ingroup plugin_api
  */
@@ -31,7 +35,7 @@
    * Form constructor.
    *
    * @param array $form
-   *   An associative array containing the structure of the form.
+   *   An associative array containing the initial structure of the plugin form.
    * @param \Drupal\Core\Form\FormStateInterface $form_state
    *   The current state of the form.
    *
@@ -44,7 +48,8 @@ public function buildConfigurationForm(array $form, FormStateInterface $form_sta
    * Form validation handler.
    *
    * @param array $form
-   *   An associative array containing the structure of the form.
+   *   An associative array containing the structure of the plugin form as built
+   *   by static::buildForm().
    * @param \Drupal\Core\Form\FormStateInterface $form_state
    *   The current state of the form.
    */
@@ -54,7 +59,8 @@ public function validateConfigurationForm(array &$form, FormStateInterface $form
    * Form submission handler.
    *
    * @param array $form
-   *   An associative array containing the structure of the form.
+   *   An associative array containing the structure of the plugin form as built
+   *   by static::buildForm().
    * @param \Drupal\Core\Form\FormStateInterface $form_state
    *   The current state of the form.
    */