diff --git a/core/lib/Drupal/Core/Entity/ContentEntityBase.php b/core/lib/Drupal/Core/Entity/ContentEntityBase.php
index 62c464d..3174a83 100644
--- a/core/lib/Drupal/Core/Entity/ContentEntityBase.php
+++ b/core/lib/Drupal/Core/Entity/ContentEntityBase.php
@@ -39,13 +39,18 @@
   /**
    * The plain data values of the contained fields.
    *
-   * This always holds the original, unchanged values of the entity. The values
-   * are keyed by language code, whereas LanguageInterface::LANGCODE_DEFAULT
-   * is used for values in default language.
+   * This a multidimensional array holding the original, unchanged values of
+   * the entity. The first key is a field name, the second is language code
+   * the third is delta, the fourth is column name. The second index for the
+   * default language (for eg. en) is LanguageInterface::LANGCODE_DEFAULT.
+   * This is however index only: for the langcode field the value is the
+   * literal langcode, for example 'en'.
    *
    * @todo: Add methods for getting original fields and for determining
    * changes.
    * @todo: Provide a better way for defining default values.
+   * @todo: currently only LanguageInterface::LANGCODE_DEFAULT is supported
+   * see https://www.drupal.org/node/2137801
    *
    * @var array
    */
@@ -138,7 +143,10 @@
   protected $entityKeys = array();
 
   /**
-   * Overrides Entity::__construct().
+   * {@inheritdoc}
+   *
+   * @param array $values
+   *   See ContentEntityBase::$values.
    */
   public function __construct(array $values, $entity_type, $bundle = FALSE, $translations = array()) {
     $this->entityTypeId = $entity_type;