diff --git a/core/modules/simpletest/src/AssertContentTrait.php b/core/modules/simpletest/src/AssertContentTrait.php
index 4306f43..52cdb63 100644
--- a/core/modules/simpletest/src/AssertContentTrait.php
+++ b/core/modules/simpletest/src/AssertContentTrait.php
@@ -485,9 +485,9 @@ protected function assertNoEscaped($raw, $message = '', $group = 'Other') {
   /**
    * Passes if the text IS found on the text version of the page.
    *
-   * 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.
+   * HTML tags in this text will be stripped out of the contents.
+   * This includes e.g. text inside input elements, so use assertRaw()
+   * to find text inside / including HTML.
    *
    * @param string $text
    *   Plain text to look for.
@@ -503,6 +503,8 @@ protected function assertNoEscaped($raw, $message = '', $group = 'Other') {
    *
    * @return bool
    *   TRUE on pass, FALSE on fail.
+   *
+   * @see assertRaw()
    */
   protected function assertText($text, $message = '', $group = 'Other') {
     return $this->assertTextHelper($text, $message, $group, FALSE);
@@ -511,9 +513,9 @@ protected function assertText($text, $message = '', $group = 'Other') {
   /**
    * Passes if the text is NOT found on the text version of the page.
    *
-   * 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.
+   * HTML tags in this text will be stripped out of the contents.
+   * This includes e.g. text inside input elements, so use assertNoRaw()
+   * to find text inside / including HTML.
    *
    * @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 assertNoRaw()
    */
   protected function assertNoText($text, $message = '', $group = 'Other') {
     return $this->assertTextHelper($text, $message, $group, TRUE);