diff --git a/core/lib/Drupal/Component/Utility/Html.php b/core/lib/Drupal/Component/Utility/Html.php
index bb25644..72aa734 100644
--- a/core/lib/Drupal/Component/Utility/Html.php
+++ b/core/lib/Drupal/Component/Utility/Html.php
@@ -338,6 +338,9 @@ public static function escapeCdataElement(\DOMNode $node, $comment_start = '//',
    * "&lt;", not "<"). Be careful when using this function, as it will revert
    * previous sanitization efforts (&lt;script&gt; will become <script>).
    *
+   * html_entity_decode() is preferred over htmlspecialchars_decode() as Drupal
+   * output UTF-8 which supports characters such as "é".
+   *
    * @param string $text
    *   The text to decode entities in.
    *
@@ -354,6 +357,9 @@ public static function decodeEntities($text) {
    * Already escaped entities will be double-escaped ("&lt;" becomes
    * "&amp;lt;").
    *
+   * htmlspecialchars() is preferred over htmlentities() as Drupal outputs UTF-8
+   * and therefore does not need to encode characters such as "é".
+   *
    * @param string $text
    *   The text to encode entities in.
    *