Add some missing examples

Author: swissspidy

src/Context/WhenStepDefinitions.php

@@ -26,6 +26,13 @@ public function wpcli_tests_capture_email_sends( $stdout ) {
 	/**
 	 * Launch a given command in the background.
 	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   Given a WP install
+	 *   And I launch in the background `wp server --host=localhost --port=8181`
+	 *   ...
+	 * ```
+	 *
 	 * @access public
 	 *
 	 * @When /^I launch in the background `([^`]+)`$/
@@ -39,6 +46,25 @@ public function when_i_launch_in_the_background( $cmd ) {
 	 *
 	 * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes.
 	 *
+	 * So if using `run` and the command errors, the step will fail.
+	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   When I run `wp core version`
+	 *   Then STDOUT should contain:
+	 *     """
+	 *     6.8
+	 *     """
+	 *
+	 * Scenario: My other scenario
+	 *   When I try `wp i18n make-pot foo bar/baz.pot`
+	 *   Then STDERR should contain:
+	 *     """
+	 *     Error: Not a valid source directory.
+	 *     """
+	 *   And the return code should be 1
+	 * ```
+	 *
 	 * @access public
 	 *
 	 * @When /^I (run|try) `([^`]+)`$/
@@ -54,6 +80,15 @@ public function when_i_run( $mode, $cmd ) {
 	 *
 	 * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes.
 	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   When I run `wp core is-installed`
+	 *   Then STDOUT should be empty
+	 *
+	 *   When I run `wp core is-installed` from 'foo/wp-content'
+	 *   Then STDOUT should be empty
+	 * ```
+	 *
 	 * @access public
 	 *
 	 * @When /^I (run|try) `([^`]+)` from '([^\s]+)'$/
@@ -69,6 +104,21 @@ public function when_i_run_from_a_subfolder( $mode, $cmd, $subdir ) {
 	 *
 	 * `run` expects an exit code 0, whereas `try` allows for non-zero exit codes.
 	 *
+	 * ```
+	 * Scenario: My example scenario
+	 *   When I run `wp site option update admin_user_id 1`
+	 *   Then STDOUT should contain:
+	 *     """
+	 *     Success: Updated 'admin_user_id' site option.
+	 *     """
+	 *
+	 *   When I run the previous command again
+	 *   Then STDOUT should contain:
+	 *     """
+	 *     Success: Value passed for 'admin_user_id' site option is unchanged.
+	 *     """
+	 * ```
+	 *
 	 * @access public
 	 *
 	 * @When /^I (run|try) the previous command again$/