Fixing links and HTML.

Author: dobooth

docs/commands/codeception.md

@@ -1,11 +1,11 @@
 # CLI commands: vendor/bin/codecept
 
-
-<div class="bs-callout bs-callout-warning">
+<div class="bs-callout bs-callout-warning" markdown="1">
 We do not recommend using Codeception commands directly as they can break the MFTF basic workflow.
-All the Codeception commands you need are wrapped using the [`mftf` tool][].</div>
+All the Codeception commands you need are wrapped using the [`mftf` tool][].
 
 To run the Codeception testing framework commands directly, change your directory to the `<Magento root>`.
+</div>
 
 ## Usage examples
 
@@ -35,7 +35,7 @@ vendor/bin/codecept run functional --group example --skip-group skip
 vendor/bin/codecept run
 ```
 
-<div class="bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info">
 The following documentation corresponds to Codeception 2.3.8.
 </div>
 

docs/configuration.md

@@ -18,7 +18,7 @@ Example:
 MAGENTO_BASE_URL=http://magento2.vagrant251
 ```
 
-<div class=".bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info" markdown="1">
 If the `MAGENTO_BASE_URL` contains a subdirectory (like `http://magento.test/magento2ce`), specify [`MAGENTO_CLI_COMMAND_PATH`][].
 </div>
 
@@ -86,7 +86,7 @@ SELENIUM_PROTOCOL=http
 SELENIUM_PATH=/wd/hub
 ```
 
-<div class=".bs-callout .bs-callout-warning">
+<div class="bs-callout bs-callout-warning" markdown="1">
 `SELENIUM_*` values are required if you are running Selenium on an external system.
 If you change the configuration of the external Selenium server, you must update these values.
 </div>

docs/credentials.md

@@ -49,8 +49,9 @@ carriers_usps_password=Lmgxvrq89uPwECeV
 ....
 ```
 
-{: .bs-callout .bs-callout-info }
+<div class="bs-callout bs-callout-info" markdown="1">
 The `/` symbol is not supported in a key name.
+</div>
 
 You are free to use any other keys you like, as they are merely the keys to reference from your tests.
 
@@ -89,7 +90,7 @@ The MFTF dynamically retrieves, encrypts, and decrypts the sensitive data during
 Decrypted credentials do not appear in the console, error logs, or [test reports][].
 The decrypted values are only available in the `.credentials` file.
 
-<div class=".bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info">
 The MFTF tests delivered with Magento application do not use credentials and do not cover external services, because of sensitivity of the data.</div>
 
 <!-- Link definitions -->

docs/extending.md

@@ -11,8 +11,9 @@ You can create or update any component of the parent body in your new test/actio
 
 Specify needed variations for a parent object and produce a copy of the original that incorporates the specified changes (the "delta").
 
+<div class="bs-callout bs-callout-info">
 Unlike merging, the parent test (or action group) will still exist after the test generation.
- {:.bs-callout .bs-callout-info}
+</div>
 
 ## Extending tests
 

docs/getting-started.md

@@ -1,8 +1,7 @@
 # Getting started
 
-<div class="bs-callout bs-callout-info">
-<a href="https://devdocs.magento.com/mftf/introduction.html#find-version">Find out your version</a> of the MFTF.
-
+<div class="bs-callout bs-callout-info" markdown="1">
+[Find your MFTF version][] of the MFTF.
 The latest Magento 2.3 release supports MFTF 2.3.13.
 The latest Magento 2.2 release supports MFTF 2.3.8.
 </div>
@@ -16,9 +15,9 @@ Make sure that you have the following software installed and configured on your
 - [Java 1.8 or later][java]
 - [Selenium Server Standalone 3.6 or later][selenium server] and [ChromeDriver 2.33 or later][chrome driver] or other webdriver in the same directory
 
-{:.bs-callout .bs-callout-tip}
+<div class="bs-callout bs-callout-tip" markdown="1">
 [PhpStorm] supports [Codeception test execution][], which is helpful when debugging.
-
+</div>
 ## Install Magento {#install-magento}
 
 Use instructions below to install Magento.
@@ -68,7 +67,7 @@ To disable the WYSIWYG and enable the web driver to process these fields as simp
 3. In the WYSIWYG Options section set the **Enable WYSIWYG Editor** option to **Disabled Completely**.
 4. Click **Save Config**.
 
-<div class=".bs-callout .bs-callout-tip">
+<div class="bs-callout bs-callout-tip">
 When you want to test the WYSIWYG functionality, re-enable WYSIWYG in your test suite.
 </div>
 
@@ -115,7 +114,7 @@ vendor/bin/mftf generate:urn-catalog --force .idea/
 
 See [`generate:urn-catalog`][] for more details.'
 
-<div class=".bs-callout .bs-callout-tip">
+<div class="bs-callout bs-callout-tip" markdown="1">
 You can simplify command entry by adding the  absolute  path to the `vendor/bin` directory path to your PATH environment variable.
 After adding the path, you can run `mftf` without having to include `vendor/bin`.
 </div>
@@ -142,8 +141,9 @@ Specify the following parameters, which are required to launch tests:
 - `MAGENTO_ADMIN_PASSWORD` must contain the user password required for authorization in the Admin area.
   Example: `MAGENTO_ADMIN_PASSWORD=123123q`
 
-{: .bs-callout .bs-callout-info }
+<div class="bs-callout bs-callout-info" markdown="1">
 If the `MAGENTO_BASE_URL` contains a subdirectory like `http://magento.test/magento2ce`, specify `MAGENTO_CLI_COMMAND_PATH`.
+</div>
 
 Learn more about environmental settings in [Configuration][].
 
@@ -300,8 +300,9 @@ allure serve dev/tests/_output/allure-results/
 [install Allure]: https://github.com/allure-framework/allure2#download
 [java]: http://www.oracle.com/technetwork/java/javase/downloads/index.html
 [mftf tests]: introduction.md#mftf-tests
-[php]: https://devdocs.magento.com/guides/2.3/install-gde/system-requirements-tech.md#php
+[php]: https://devdocs.magento.com/guides/v2.3/install-gde/system-requirements-tech.md#php
 [PhpStorm]: https://www.jetbrains.com/phpstorm/
 [selenium server]: https://www.seleniumhq.org/download/
 [Set up a standalone MFTF]: #set-up-a-standalone-mftf
 [test suite]: suite.md
+[Find your MFTF version]: introduction.md#find-your-mftf-version

docs/introduction.md

@@ -1,6 +1,6 @@
-# Introduction to the Magento Functional Testing Framework version 2.3
+# Introduction to the Magento Functional Testing Framework
 
-<a href="https://devdocs.magento.com/mftf/introduction.html#find-version">Find out your version</a> of the MFTF.
+[Find your MFTF version][] of the MFTF.
 
 The latest Magento 2.3 release supports MFTF 2.3.13.
 The latest Magento 2.2 release supports MFTF 2.3.8.
@@ -15,9 +15,11 @@ MFTF improves:
 - **Maintainability** based on simple test creation and overall structure.
 
 Because MFTF tests are written in XML, you no longer need to learn PHP to write tests.
-<div class=".bs-callout .bs-callout-info">
+
+<div class="bs-callout bs-callout-info" markdown="1">
 We are actively developing functional tests.
 Refer to `<magento_root>/app/code/<vendor_name>/<module_name>/Test/Mftf/` for examples.
+Check out the [MFTF Test Migration][] repo.
 </div>
 
 ## Audience
@@ -46,7 +48,7 @@ As a Magento developer, test changes, such as extended search functionality, a n
 
 As a software engineer, perform regression testing before release to ensure that Magento works as expected with new functionality.
 
-## Find your MFTF version {#find-version}
+## Find your MFTF version
 
 There are two options to find out your MFTF version:
 
@@ -132,4 +134,6 @@ Follow the [MFTF project] and [contribute on Github].
 <!-- Link definitions -->
 [contribute on Github]: https://github.com/magento/magento2-functional-testing-framework/blob/master/.github/CONTRIBUTING.md
 [Functional Testing Framework]: https://devdocs.magento.com/guides/v2.3/mtf/mtf_introduction.html
-[MFTF project]: https://github.com/magento/magento2-functional-testing-framework
+[MFTF project]: https://github.com/magento/magento2-functional-testing-framework
+[Find your MFTF version]: #find-your-mftf-version
+[MFTF Test Migration]: https://github.com/magento/magento-functional-tests-migration

docs/reporting.md

@@ -277,7 +277,7 @@ Each time you run tests, the MFTF appends an XML file with results at the `tests
 
 The official [Allure Test Report][] documentation is well-covered, so we'll list only the CLI commands that you would need for your day-to-day work.
 
-<div class=".bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info">
 The following commands are relative to the Magento installation directory.
 </div>
 
@@ -299,7 +299,7 @@ To launch the generated report in a web browser:
 allure open dev/tests/acceptance/tests/_output/allure-report
 ```
 
-<div class="bs-callout bs-callout-info">
+<div class="bs-callout bs-callout-info" markdown="1">
 By default, Allure generates reports in the `allure-report/` at the current directory.
 For example, if you run the command without `-o` flag while you are in the `magento2/` directory, Allure will generate a report at the `magento2/allure-report/` directory.
 </div>

docs/section/parameterized-selectors.md

@@ -1,6 +1,5 @@
 # Parameterized selectors
 
-
 Use the following examples to create and use parameterized selectors in the MFTF.
 
 ## Set up a selector in section
@@ -73,7 +72,7 @@ For the parameterized part of the selector, add `{{var1}}, {{var2}}, ..., {{varN
 </section>
 ```
 
-<div class="bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info" markdown="1">
 There is no need to use sequential variables like `{{var1}}`, `{{var2}}`. Parameterized replacement reads variables and maps them to the test call of the element sequentially from left to right, meaning you can use a selector like `#element .{{categoryId}} .{{productId}}`."
 </div>
 

docs/test.md

@@ -6,7 +6,7 @@ Test cases in the Magento Functional Testing Framework (MFTF) are defined in XML
 MFTF `<tests>` is considered a sequence of actions with associated parameters.
 Any failed [assertion] within a test constitutes a failed test.
 
-<div class="bs-callout bs-callout-info">
+<div class="bs-callout bs-callout-info" markdown="1">
  `<before>` and `<after>` hooks are not global within `<tests>`.
 They only apply to the `<test>` in which they are declared.
 The steps in `<after>` are run in both successful **and** failed test runs.

docs/test/actions.md

@@ -1,6 +1,5 @@
 # Test actions
 
-
 Actions in the MFTF allow you to automate different scenarios of Magento user's actions.
 They are mostly XML implementations of [Codeception actions](http://codeception.com/docs/modules/WebDriver#Actions).
 Some actions drive browser elements, while others use REST APIs.
@@ -153,7 +152,6 @@ The only difference is that different data is assigned to the attributes, which
 <!-- {% endraw %} -->
 
 Here, [`<click>`](#click) performs a click on a button that can be found by the selector that is stored in the `signInAccountButton` of the `StorefrontCustomerSignInFormSection`.
-See the `StorefrontCustomerSignInPage.xml` file code in [step 2](#section-code).
 
 ## Actions returning a variable
 
@@ -1349,7 +1347,7 @@ Note that the makeScreenshot action does not automatically add the screenshot to
 <makeScreenshot userInput="example" stepKey="screenshotPage"/>
 ```
 
-<div class=".bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info">
 This action does not add a screenshot to the Allure [report](../reporting.md).</div>
 
 ### maximizeWindow
@@ -2474,7 +2472,7 @@ Attribute|Type|Use|Description
 
 Wait for all Magento loading overlays to disappear.
 
-<div class=".bs-callout .bs-callout-info">
+<div class="bs-callout bs-callout-info">
 The CSS class for loading masks is not used consistently throughout Magento.
 Therefore, this convenience function tries to wait for various specific selectors.</div>