diff --git a/core/lib/Drupal/Core/Template/AttributeArray.php b/core/lib/Drupal/Core/Template/AttributeArray.php
index 020a050..24e9c9d 100644
--- a/core/lib/Drupal/Core/Template/AttributeArray.php
+++ b/core/lib/Drupal/Core/Template/AttributeArray.php
@@ -30,7 +30,10 @@
 class AttributeArray extends AttributeValueBase implements \ArrayAccess, \IteratorAggregate {
 
   /**
-   * An empty array after calling array_filter should not print '$name=""'.
+   * Ensures empty array as a result of array_filter will not print '$name=""'.
+   *
+   * @see \Drupal\Core\Template\AttributeArray::__toString()
+   * @see \Drupal\Core\Template\AttributeValueBase::render()
    */
   const PRINT_IF_EMPTY_STRING = FALSE;
 
diff --git a/core/lib/Drupal/Core/Template/AttributeValueBase.php b/core/lib/Drupal/Core/Template/AttributeValueBase.php
index 84dc929..f1f8a96 100644
--- a/core/lib/Drupal/Core/Template/AttributeValueBase.php
+++ b/core/lib/Drupal/Core/Template/AttributeValueBase.php
@@ -17,7 +17,9 @@
 abstract class AttributeValueBase {
 
   /**
-   * Renders '$name=""' if $value is to an empty string.
+   * Renders '$name=""' if $value is to empty string.
+   *
+   * @see \Drupal\Core\Template\AttributeValueBase::render()
    */
   const PRINT_IF_EMPTY_STRING = TRUE;