diff -u b/core/lib/Drupal/Component/Utility/Html.php b/core/lib/Drupal/Component/Utility/Html.php
--- b/core/lib/Drupal/Component/Utility/Html.php
+++ b/core/lib/Drupal/Component/Utility/Html.php
@@ -393,6 +393,15 @@
     return htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
   }
 
+  /**
+   * Decodes HTML entities back to characters.
+   *
+   * @param $text
+   *   The input text
+   *
+   * @return string
+   *   The text with all HTML entities decoded back to characters.
+   */
   public static function descape($text) {
     return htmlspecialchars_decode($text, ENT_QUOTES | ENT_SUBSTITUTE);
   }