From a6affde1dc05a57787f44d90427d9d44d4db4ddc Mon Sep 17 00:00:00 2001
From: Ji Lu <jilu1@adobe.com>
Date: Fri, 14 Aug 2020 20:50:06 -0500
Subject: [PATCH] MQE-2110: MFTF command to pause test execution

---
 docs/commands/mftf.md     | 14 +++++++++++++-
 docs/interactive-pause.md |  8 +++++---
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/docs/commands/mftf.md b/docs/commands/mftf.md
index b3365cfa0..0d74c1efb 100644
--- a/docs/commands/mftf.md
+++ b/docs/commands/mftf.md
@@ -585,16 +585,28 @@ vendor/bin/mftf codecept:run [<suite|test>] --[<option(s)>]
 ```bash
 # Run all tests in functional suite
 vendor/bin/mftf codecept:run functional
+```
+
+```bash
 # Run all tests in functional suite with options
 vendor/bin/mftf codecept:run functional --verbose --steps --debug
+```
+
+```bash
 # Run one test
 vendor/bin/mftf codecept:run functional Magento/_generated/default/AdminCreateCmsPageTestCest.php --debug
+```
+
+```bash
 # Run all tests in default group
 vendor/bin/mftf codecept:run functional --verbose --steps -g default
 ```
 
 <div class="bs-callout-warning">
-Note: You may want to limit the usage of this Codeception command with arguments and options for `acceptance` only, since it is what is supported by MFTF. You should also change `acceptance` to `functional` when using this command when referring to Codeception documentation.
+<p>
+Note: You may want to limit the usage of this Codeception command with arguments and options for "acceptance" only, since it is what's supported by MFTF. 
+When using this command, you should change "acceptance" to "functional" when referring to Codeception documentation.
+</p>
 </div>
 
 <!-- LINK DEFINITIONS -->
diff --git a/docs/interactive-pause.md b/docs/interactive-pause.md
index 25e0f7f0e..250f19936 100644
--- a/docs/interactive-pause.md
+++ b/docs/interactive-pause.md
@@ -61,9 +61,11 @@ vendor/bin/mftf codecept:run --debug
 ```
 
 <div class="bs-callout-warning">
-Note: MFTF run command's `--debug` option is different from Codeception `--debug` mode option. 
+<p>
+Note: MFTF command "--debug" option has different meaning than Codeception command "--debug" mode option.
+</p>
 </div>
 
-## References
+<!-- Link definitions -->
 
-[pause on codeception.com](https://codeception.com/docs/02-GettingStarted#Interactive-Pause)
+[pause on codeception.com]: https://codeception.com/docs/02-GettingStarted#Interactive-Pause