docs: improve descritpion on see*() method

They are not assertions.

Author: kenjis

user_guide_src/source/testing/response.rst

@@ -178,7 +178,8 @@ are useful for using within assertions in your tests.
 see()
 -----
 
-The ``see()`` method checks the text on the page to see if it exists either by itself, or more specifically within
+Returns a boolean true/false based on whether the text on the page exists either
+by itself, or more specifically within
 a tag, as specified by type, class, or id:
 
 .. literalinclude:: response/018.php

user_guide_src/source/testing/response/018.php

@@ -1,10 +1,21 @@
 <?php
 
 // Check that "Hello World" is on the page
-$results->see('Hello World');
+if ($results->see('Hello World')) {
+    // ...
+}
+
 // Check that "Hello World" is within an h1 tag
-$results->see('Hello World', 'h1');
+if ($results->see('Hello World', 'h1')) {
+    // ...
+}
+
 // Check that "Hello World" is within an element with the "notice" class
-$results->see('Hello World', '.notice');
+if ($results->see('Hello World', '.notice')) {
+    // ...
+}
+
 // Check that "Hello World" is within an element with id of "title"
-$results->see('Hello World', '#title');
+if ($results->see('Hello World', '#title')) {
+    // ...
+}

user_guide_src/source/testing/response/019.php

@@ -1,6 +1,11 @@
 <?php
 
 // Checks that "Hello World" does NOT exist on the page
-$results->dontSee('Hello World');
+if ($results->dontSee('Hello World')) {
+    // ...
+}
+
 // Checks that "Hellow World" does NOT exist within any h1 tag
-$results->dontSee('Hello World', 'h1');
+if ($results->dontSee('Hello World', 'h1')) {
+    // ...
+}

user_guide_src/source/testing/response/020.php

@@ -1,8 +1,16 @@
 <?php
 
 // Check that an element with class 'notice' exists
-$results->seeElement('.notice');
+if ($results->seeElement('.notice')) {
+    // ...
+}
+
 // Check that an element with id 'title' exists
-$results->seeElement('#title');
+if ($results->seeElement('#title')) {
+    // ...
+}
+
 // Verify that an element with id 'title' does NOT exist
-$results->dontSeeElement('#title');
+if ($results->dontSeeElement('#title')) {
+    // ...
+}

user_guide_src/source/testing/response/021.php

@@ -1,6 +1,11 @@
 <?php
 
 // Check that a link exists with 'Upgrade Account' as the text::
-$results->seeLink('Upgrade Account');
+if ($results->seeLink('Upgrade Account')) {
+    // ...
+}
+
 // Check that a link exists with 'Upgrade Account' as the text, AND a class of 'upsell'
-$results->seeLink('Upgrade Account', '.upsell');
+if ($results->seeLink('Upgrade Account', '.upsell')) {
+    // ...
+}

user_guide_src/source/testing/response/022.php

@@ -1,6 +1,11 @@
 <?php
 
 // Check that an input exists named 'user' with the value 'John Snow'
-$results->seeInField('user', 'John Snow');
+if ($results->seeInField('user', 'John Snow')) {
+    // ...
+}
+
 // Check a multi-dimensional input
-$results->seeInField('user[name]', 'John Snow');
+if ($results->seeInField('user[name]', 'John Snow')) {
+    // ...
+}

user_guide_src/source/testing/response/023.php

@@ -1,6 +1,11 @@
 <?php
 
 // Check if checkbox is checked with class of 'foo'
-$results->seeCheckboxIsChecked('.foo');
+if ($results->seeCheckboxIsChecked('.foo')) {
+    // ...
+}
+
 // Check if checkbox with id of 'bar' is checked
-$results->seeCheckboxIsChecked('#bar');
+if ($results->seeCheckboxIsChecked('#bar')) {
+    // ...
+}