diff --git a/core/modules/simpletest/src/AssertContentTrait.php b/core/modules/simpletest/src/AssertContentTrait.php
index 4306f43..9c87c76 100644
--- a/core/modules/simpletest/src/AssertContentTrait.php
+++ b/core/modules/simpletest/src/AssertContentTrait.php
@@ -392,6 +392,8 @@ protected function assertNoLinkByHref($href, $message = '', $group = 'Other') {
    *
    * @return bool
    *   TRUE on pass, FALSE on fail.
+   *
+   * @see \Drupal\simpletest\AssertContentTrait::assertRaw()
    */
   protected function assertRaw($raw, $message = '', $group = 'Other') {
     if (!$message) {
@@ -483,11 +485,10 @@ protected function assertNoEscaped($raw, $message = '', $group = 'Other') {
   }
 
   /**
-   * Passes if the text IS found on the text version of the page.
+   * Passes if the page (with HTML stripped) contains the text.
    *
-   * The text version is the equivalent of what a user would see when viewing
-   * through a web browser. In other words the HTML has been filtered out of the
-   * contents.
+   * Note that stripping HTML tags also removes their attributes, such as
+   * the values of text fields.
    *
    * @param string $text
    *   Plain text to look for.
@@ -503,17 +504,18 @@ protected function assertNoEscaped($raw, $message = '', $group = 'Other') {
    *
    * @return bool
    *   TRUE on pass, FALSE on fail.
+   *
+   * @see \Drupal\simpletest\AssertContentTrait::assertRaw()
    */
   protected function assertText($text, $message = '', $group = 'Other') {
     return $this->assertTextHelper($text, $message, $group, FALSE);
   }
 
   /**
-   * Passes if the text is NOT found on the text version of the page.
+   * Passes if the page (with HTML stripped) does not contains the text.
    *
-   * The text version is the equivalent of what a user would see when viewing
-   * through a web browser. In other words the HTML has been filtered out of the
-   * contents.
+   * Note that stripping HTML tags also removes their attributes, such as
+   * the values of text fields.
    *
    * @param string $text
    *   Plain text to look for.
@@ -529,6 +531,8 @@ protected function assertText($text, $message = '', $group = 'Other') {
    *
    * @return bool
    *   TRUE on pass, FALSE on fail.
+   *
+   * @see \Drupal\simpletest\AssertContentTrait::assertNoRaw()
    */
   protected function assertNoText($text, $message = '', $group = 'Other') {
     return $this->assertTextHelper($text, $message, $group, TRUE);