MQE-1963: Update XSD Schema to verify that file has only single entity

- DevDocs update

Author: jilu1

docs/best-practices.md

@@ -113,7 +113,7 @@ Use a lower case first letter for:
 ## Page object
 
 1. One `<page>` tag is allowed per page XML file.
-2. Use [parameterized selectors] for constructing a selector when test specific or runtime generated information is needed.
+2. Use [parameterized selectors] for constructing a selector when test-specific or runtime-generated information is needed.
 Do not use them for static elements.
 
 <span class="color:red">

docs/commands/mftf.md

@@ -28,7 +28,7 @@ vendor/bin/mftf build:project
 vendor/bin/mftf build:project --upgrade
 ```
 
-Upgrades the all installed MFTF tests after the MFTF major upgrade.
+Upgrades all installed MFTF tests after a major MFTF upgrade.
 
 ### Generate all tests
 
@@ -506,8 +506,8 @@ vendor/bin/mftf static-checks testDependencies actionGroupArguments
 
 ### `upgrade:tests`
 
-When path argument is specified, this command will apply all the MFTF major version upgrade scripts to test components in the given path (`test.xml`, `data.xml`, etc);
-otherwise it will apply all the MFTF major version upgrade scripts to all installed test components.
+When the path argument is specified, this command applies all the major version MFTF upgrade scripts to the test components in the given path (test.xml, data.xml, etc).
+Otherwise, it will apply all the major version MFTF upgrade scripts to all installed test components.
 
 #### Usage
 
@@ -520,7 +520,7 @@ The command searches recursively for any `*.xml` files to upgrade.
 
 #### Examples
 
-To upgrade all installed MFTF tests
+To upgrade all installed MFTF tests:
 
 ```bash
 vendor/bin/mftf upgrade:tests

docs/section.md

@@ -48,7 +48,6 @@ The following conventions apply to MFTF sections:
 -  `*Section.xml` is stored in the _Section_ directory of a module.
 -  The name format is `{Admin|Storefront}{SectionDescription}Section.xml`.
 -  Camel case is used for `<section>` elements.
-They describe the function of the element rather than attempting to describe the selector used.
 -  One `<section>` tag is allowed per section XML file.
 
 ## Example