diff --git a/docs/section.md b/docs/section.md index 421c98fdd..68a6507af 100644 --- a/docs/section.md +++ b/docs/section.md @@ -58,11 +58,11 @@ Example (`.../Catalog/Section/AdminCategorySidebarActionSection.xml` file): -
- - -
+ xsi:noNamespaceSchemaLocation="urn:magento:mftf:Page/etc/SectionObject.xsd"> +
+ + +
``` @@ -70,14 +70,14 @@ This example uses a `AdminCategorySidebarActionSection` section. All sections wi The `AdminCategorySidebarActionSection` section declares two buttons: -- `addRootCategoryButton` - button with a `#add_root_category_button` locator on the parent web page -- `addSubcategoryButton` - button with a `#add_subcategory_button` locator on the parent web page +- `AddRootCategoryButton` - button with a `#add_root_category_button` locator on the parent web page +- `AddSubcategoryButton` - button with a `#add_subcategory_button` locator on the parent web page The following is an example of a call in test: ```xml - + ``` ## Elements reference @@ -116,21 +116,21 @@ The most usual use case is a test step with a button click action. The section element code declaration containing the timeout attribute: -> StorefrontSigninSection.xml +> StorefrontCustomerSignInPopupFormSection.xml ```xml ... - + ... ``` The test step that covers the use case: -> StorefrontSigninTest.xml +> CaptchaWithDisabledGuestCheckoutTest.xml ```xml ... - + ... ``` diff --git a/docs/section/locator-functions.md b/docs/section/locator-functions.md index 1e3dffd24..d2dc9924c 100644 --- a/docs/section/locator-functions.md +++ b/docs/section/locator-functions.md @@ -31,7 +31,7 @@ An element cannot, however, have both a `selector` and a `locatorFunction`. Given the above element definitions, you call the elements in a test just like any other element. No special reference is required, as you are still just referring to an `element` inside a `section`: ```xml - + diff --git a/docs/suite.md b/docs/suite.md index 7917cd347..9f623f276 100644 --- a/docs/suite.md +++ b/docs/suite.md @@ -6,8 +6,8 @@ You can form suites using separate tests, groups, and modules. Each suite must be defined in the `//Test/Mftf/Suite` directory. -The tests for each suite are generated in a separate directory under `/dev/tests/acceptance/tests/functional/Magento/FunctionalTest/_generated/`. -All tests that are not within a suite are generated in the _default_ suite at `.../Magento/FunctionalTest/_generated/default/`. +The tests for each suite are generated in a separate directory under `/dev/tests/acceptance/tests/functional/Magento/_generated/`. +All tests that are not within a suite are generated in the _default_ suite at `/dev/tests/acceptance/tests/functional/Magento/_generated/default`.
If a test is generated into at least one custom suite, it will not appear in the _default_ suite. @@ -61,7 +61,7 @@ The code lives in one place and executes once per suite. - Set up preconditions and postconditions using [actions] in [``] and [``] correspondingly, just similar to use in a [test]. - Clean up after suites just like after tests. - The MFTF enforces the presence of both `` and `` if either is present. +MFTF enforces the presence of both `` and `` if either is present. ## Test writing @@ -142,7 +142,7 @@ This suite includes all tests that contain the `` annota ### Execute Magento CLI commands in suite conditions ```xml - + @@ -170,7 +170,7 @@ The suite includes a specific test `SomeCacheRelatedTest` and every `` tha ### Change Magento configurations in suite conditions ```xml - + diff --git a/docs/update.md b/docs/update.md index ebd096158..dc5e7fbc8 100644 --- a/docs/update.md +++ b/docs/update.md @@ -1,7 +1,9 @@ # Update the Magento Functional Testing Framework
-Both Magento `2.2` and `2.3` supports MFTF `2.5.3` ([Find your version][] of the MFTF). +[Find your version] of MFTF. +The latest Magento 2.4.x release supports MFTF 3.x. +The latest Magento 2.3.x release supports MFTF 2.6.x.
Tests and the Framework itself are stored in different repositories. @@ -26,16 +28,24 @@ Takes place when **second** digit of version number changes. 1. Check details about backward incompatible changes in the [Changelog][] and update your new or customized tests. 1. Perform all the actions provided for [Patch Version Update][] 1. When updating from versions below `2.5.0`, verify [WYSIWYG settings][] -1. You may need to run the `upgrade:tests` using `vendor/bin/mftf upgrade:tests app` +1. You may need to run the `upgrade:tests` using `vendor/bin/mftf upgrade:tests` + +## Major version update + +Takes place when **first** digit of version number changes. + +1. Check detailed explanation and instructions on major version upgrade in [Backward Incompatible Changes][] and upgrade your new or customized tests. +1. Perform all the actions provided for [Minor Version Update][] ## After updating 1. It is a good idea to regenerate your IDE Schema Definition catalog with `vendor/bin/mftf generate:urn-catalog .idea/` -1. Update your tests, including data, metadata and other resoruces. Check if they contain tags that are unsupported in the newer version. +1. Update your tests, including data, metadata and other resources. Check if they contain tags that are unsupported in the newer version. 1. Remove the references to resources (ActionGroups, Sections, Tests) marked as deprecated. [Changelog]: https://github.com/magento/magento2-functional-testing-framework/blob/master/CHANGELOG.md +[Backward Incompatible Changes]: backward-incompatible-changes.md [WYSIWYG settings]: getting-started.md#wysiwyg-settings [Security settings]: getting-started.md#security-settings [Find your version]: introduction.md#find-your-mftf-version