diff --git a/core/lib/Drupal/Core/Render/Element/Hidden.php b/core/lib/Drupal/Core/Render/Element/Hidden.php
index 0da3405..a35c3e5 100644
--- a/core/lib/Drupal/Core/Render/Element/Hidden.php
+++ b/core/lib/Drupal/Core/Render/Element/Hidden.php
@@ -12,6 +12,19 @@
 /**
  * Provides a form element for an HTML 'hidden' input element.
  *
+ * Specify either #default_value or #value but not both.
+ *
+ * Properties:
+ * - #default_value: The initial value of the form element. JavaScript may
+ *   alter the value prior to submission.
+ * - #value: The value of the form element. The form api ensures that this value
+ *   remains unchanged by the browser.
+ *
+ * Usage example:
+ * @code
+ * $form['entity_id'] - array('#type' => 'hidden', '#value' => $entity_id);
+ * @endcode
+ *
  * @see \Drupal\Core\Render\Element\Value
  *
  * @FormElement("hidden")
diff --git a/core/lib/Drupal/Core/Render/Element/Value.php b/core/lib/Drupal/Core/Render/Element/Value.php
index 5da3e0c..2f0cbd8 100644
--- a/core/lib/Drupal/Core/Render/Element/Value.php
+++ b/core/lib/Drupal/Core/Render/Element/Value.php
@@ -10,9 +10,17 @@
 /**
  * Provides a form element for storage of internal information.
  *
- * Unlike \Drupal\Core\Render\Element\Hidden, this information is not
- * sent to the browser in a hidden form field, but is just stored in the form
- * array for use in validation and submit processing.
+ * Unlike \Drupal\Core\Render\Element\Hidden, this information is not sent to
+ * the browser in a hidden form field, but only stored in the form array for use
+ * in validation and submit processing.
+ *
+ * Properties:
+ * - #value: The value of the form element that cannot be edited by the user.
+ *
+ * Usage Example:
+ * @code
+ * $form['entity_id'] - array('#type' => 'value', '#value' => $entity_id);
+ * @endcode
  *
  * @FormElement("value")
  */