diff --git a/core/lib/Drupal/Core/Render/Element/Button.php b/core/lib/Drupal/Core/Render/Element/Button.php
index a646157..bda9084 100644
--- a/core/lib/Drupal/Core/Render/Element/Button.php
+++ b/core/lib/Drupal/Core/Render/Element/Button.php
@@ -16,6 +16,21 @@
  * When the button is pressed, the form will be submitted to Drupal, where it is
  * validated and rebuilt. The submit handler is not invoked.
  *
+ * Properties:
+ * - #limit_validation_errors: An array of form element keys that reference the
+ *   sections of the form validations that will block form submission. Specify
+ *   an empty array to supress all form validation errors.
+ *
+ * Usage Example:
+ * @code
+ * $form['actions']['preview'] = array(
+ *   '#type' => 'button',
+ *   '#value => $this->t('Preview'),
+ * );
+ * @endcode
+ *
+ * @see \Drupal\Core\Render\Element\Submit
+ *
  * @FormElement("button")
  */
 class Button extends FormElement {
diff --git a/core/lib/Drupal/Core/Render/Element/Dropbutton.php b/core/lib/Drupal/Core/Render/Element/Dropbutton.php
index 76fab89..3f7e89c 100644
--- a/core/lib/Drupal/Core/Render/Element/Dropbutton.php
+++ b/core/lib/Drupal/Core/Render/Element/Dropbutton.php
@@ -10,6 +10,25 @@
 /**
  * Provides a render element for a set of links rendered as a drop-down button.
  *
+ * Properties:
+ * - #links: An array of links to actions.
+ *
+ * @code
+ * $form['actions']['extra_actions'] = array(
+ *   '#type' => 'dropbutton',
+ *   '#links' => array(
+ *     'simple_form' => array(
+ *       'title' => $this->t('Simple Form'),
+ *       'url' => Url::fromRoute('fapi_example.simple_form'),
+ *     ),
+ *     'demo' => array(
+ *       'title' => $this->t('Build Demo'),
+ *       'url' => Url::fromRoute('fapi_example.build_demo'),
+ *     ),
+ *   ),
+ * );
+ * @endcode
+ *
  * @see \Drupal\Core\Render\Element\Operations
  *
  * @RenderElement("dropbutton")
diff --git a/core/lib/Drupal/Core/Render/Element/Operations.php b/core/lib/Drupal/Core/Render/Element/Operations.php
index 89bc68b..dd3e3c9 100644
--- a/core/lib/Drupal/Core/Render/Element/Operations.php
+++ b/core/lib/Drupal/Core/Render/Element/Operations.php
@@ -14,6 +14,8 @@
  * difference is that it offers themes the possibility to render it differently
  * through a theme suggestion.
  *
+ * @see \Drupal|Core\Render\Element\DropButton
+ *
  * @RenderElement("operations")
  */
 class Operations extends Dropbutton {
diff --git a/core/lib/Drupal/Core/Render/Element/Submit.php b/core/lib/Drupal/Core/Render/Element/Submit.php
index 41e592d..5aec250 100644
--- a/core/lib/Drupal/Core/Render/Element/Submit.php
+++ b/core/lib/Drupal/Core/Render/Element/Submit.php
@@ -13,6 +13,21 @@
  * Submit buttons are processed the same as regular buttons, except they trigger
  * the form's submit handler.
  *
+ * Properties:
+ * - #submit: Specifies an alternate callback for form submission when the
+ *   submit button is pressed.  Use '::methodName' format or an array containing
+ *   the object and method name (e.g. [ $this, 'methodName'] ).
+ *
+ * Usage Example:
+ * @code
+ * $form['actions']['submit'] = array(
+ *   '#type' => 'submit,
+ *   '#value' => $this->t('Save'),
+ * );
+ * @endcode
+ *
+ * @see \Drupal\Core\Render\Element\Button
+ *
  * @FormElement("submit")
  */
 class Submit extends Button {