Merge branch 'master' into improvement-message-queues-refresh-config

Author: dobooth

src/cloud/project/log-locations.md

@@ -13,7 +13,7 @@ Logs are useful for troubleshooting problems related to {{site.data.var.ece}} [b
 Magento-specific logs are in the `<magento-root-dir>/var/` directory. See [Magento Logging][configlog] in the _Configuration guide_.
 
 {:.bs-callout-tip}
-You can [set up log-based Slack and email notifications][slacklog] when configuring your Cloud environment.
+When you configure your Cloud environment, you can [set up log-based Slack and email notifications][slacklog] for build and deploy actions.
 
 ## Viewing logs
 

src/cloud/project/project-upgrade.md

@@ -6,25 +6,25 @@ functional_areas:
   - Upgrade
 ---
 
-You can upgrade the core {{site.data.var.ee}} code base to a newer version. It is best to review the summary of the updated [technology stack] before upgrading your project. If you need to upgrade from a version older than 2.1, you must upgrade to a supported version first. See [Upgrades and patches] for upgrade path details.
+You can upgrade the core {{site.data.var.ee}} code base to a newer version. Before upgrading your project, review the [{{site.data.var.ece}} service versions][version compatibility matrix] information for the latest software version requirements. If you need to upgrade from a version older than 2.1, you must upgrade to a supported version first. See [Upgrades and patches] for upgrade path details.
 
 {% include cloud/note-upgrade.md %}
 
 {% include cloud/note-ece-tools-package.md %}
 
-## Upgrading from older versions of the Magento application
+## Upgrade from older versions of the Magento application
 
-If you are upgrading from 2.1.4 or later to 2.2.x or later, review the [Magento technology stack requirements]. Your upgrade tasks may include the following:
+If you are upgrading from 2.1.4 or later to 2.2.x or later, review the [{{site.data.var.ece}} service versions][version compatibility matrix] information for the latest software version requirements. Your upgrade tasks may include the following:
 
 -  Upgrade your PHP version
 -  Convert an older configuration management file
 -  Update the `.magento.app.yaml` file with new settings for hooks and environment variables
--  Upgrade to the latest supported version of Fastly
+-  Upgrade third-party extensions to the latest supported version
 -  Update the `.gitignore` file
 
 ### Configuration management
 
-If you are upgrading from 2.1.4 or later to 2.2.x or later and use [Configuration Management], you need to migrate the `config.local.php` file. Older versions used a `config.local.php` file for Configuration Management, but version 2.2.0 and later use the `config.php` file. This file works exactly as the `config.local.php` file, with additional settings that include a list of your enabled modules, additional configurations, and a different name.
+If you are upgrading from 2.1.4 or later to 2.2.x or later and use [Configuration Management], you need to migrate the `config.local.php` file. Older versions used a `config.local.php` file for Configuration Management, but version 2.2.0 and later use the `config.php` file. This file works exactly like the `config.local.php` file, but it has different configuration settings that include a list of your enabled modules and additional configuration options.
 
 {:.procedure}
 To create a temporary `config.php` file:
@@ -86,9 +86,9 @@ To update the `.magento.app.yaml` file:
 
 1. Continue with the upgrade process.
 
-## Upgrading the Magento application
+## Upgrade the Magento application
 
-Review the [Magento technology stack requirements] before upgrading your Magento application.
+Review the [service versions][version compatibility matrix] information for the latest software version requirements before upgrading your Magento application.
 
 ### Back up the database
 
@@ -173,7 +173,7 @@ To create a system-specific configuration file:
 {:.bs-callout-warning}
 For an upgrade, you delete the `config.php` file. Once this file is added to your code, you should **not** delete it. If you need to remove or edit settings, you must edit the file manually.
 
-### Upgrading extensions
+### Upgrade extensions
 
 Review your third-party extension and module pages in Marketplace or other company sites to verify support for {{site.data.var.ee}} and {{site.data.var.ece}}. If you need to upgrade any third-party extensions and modules, we recommend working in a new Integration branch with your extensions disabled.
 
@@ -197,7 +197,9 @@ To verify and upgrade your extensions:
 1. Push to the Staging environment to test in a pre-production environment.
 
 We strongly recommend upgrading your Production environment _before_ including the upgraded extensions in your go-live process.
-We also recommend upgrading to the latest version of the Fastly CDN module for Magento 2.
+
+{:.bs-callout-info}
+When you upgrade your Magento version, the upgrade process updates to the latest version of the [Fastly CDN module for Magento 2] automatically.
 
 ## Troubleshoot upgrade
 
@@ -222,11 +224,11 @@ To resolve the error:
    git add -A && git commit -m "Fixed deployment failure" && git push magento <branch-name>
    ```
 
-[technology stack]: {{site.baseurl}}/guides/v2.3/install-gde/system-requirements-tech.html
+[version compatibility matrix]: {{site.baseurl}}/cloud/project/project-conf-files_services.html#service-versions
 [Upgrades and patches]: {{site.baseurl}}/cloud/project/project-upgrade-parent.html
-[Magento technology stack requirements]: {{site.baseurl}}/guides/v2.3/install-gde/system-requirements-tech.html
 [Configuration Management]: {{site.baseurl}}/cloud/live/sens-data-over.html
 [extensions section of the .magento.app.yaml file]: {{site.baseurl}}/cloud/project/project-conf-files_magento-app.html#configure-php-options
 [.magento.app.yaml]: {{site.baseurl}}/cloud/project/project-conf-files_magento-app.html
 [version constraint syntax]: {{site.baseurl}}/cloud/project/ece-tools-upgrade-project.html#metapackage
+[Fastly CDN module for Magento 2]: {{site.baseurl}}/cloud/cdn/cloud-fastly.html#fastly-cdn-module-for-magento-2
 [Examine the logs]: {{site.baseurl}}/cloud/project/log-locations.html

src/cloud/requirements/cloud-requirements.md

@@ -62,7 +62,7 @@ You cannot upgrade the software, but you can configure the following services:
 *  [Elasticsearch]({{ site.baseurl }}/cloud/project/project-conf-files_services-elastic.html)
 
  {:.bs-callout-info}
-See [Magento technology stack requirements]({{ site.baseurl }}/guides/v2.3/install-gde/system-requirements-tech.html) for the latest software version requirements.
+See the [{{site.data.var.ece}} service versions][version compatibility matrix] information for the latest software version requirements.
 
 For Staging and Production environments, you use the Fastly CDN module for Magento 2 for CDN and caching services. See [Configure Fastly services]({{ site.baseurl }}/cloud/cdn/cloud-fastly.html#fastly-cdn-module-for-magento-2).
 
@@ -133,3 +133,6 @@ Your {{site.data.var.ee}} account must *authenticate* using any of the following
 *  Bitbucket
 *  Google
 *  Create your own Cloud account
+
+<!--link definitions-->
+[version compatibility matrix]: {{site.baseurl}}/cloud/project/project-conf-files_services.html#service-versions

src/common/images/body-class-result.png

@@ -23,7 +23,7 @@ Following are some common module directories:
 *  `etc`: contains configuration files; in particular, `module.xml`, which is required.
 *  `Model`: contains PHP model classes as part of MVC vertical implementation of module logic.
 *  `Setup`: contains classes for module database structure and data setup which are invoked when installing or upgrading.
-*  `ViewModel`: contains PHP model clasees as part of a model-view-viewmodel (MVVM) implementation. It allows developers to offload features and business logic from block classes into separate classes that are easier to maintain, test, and reuse.
+*  `ViewModel`: contains PHP model classes as part of a model-view-viewmodel (MVVM) implementation. It allows developers to offload features and business logic from block classes into separate classes that are easier to maintain, test, and reuse.
 
 #### Additional directories
 {:.no_toc}

src/guides/v2.3/extension-dev-guide/build/module-file-structure.md

@@ -109,7 +109,7 @@ To extend a Module's styles in your theme:
    │   ├── web/
    │   │   ├── css/
    │   │   │   ├── source/
-               ├──_extend.less
+                  ├──_extend.less
    ...
    ```
 

src/guides/v2.3/frontend-dev-guide/css-guide/css_quick_guide_approach.md

@@ -182,6 +182,8 @@ The following table describes the instructions specific for page configuration f
           <li><code>&lt;css&gt;</code></li>
           <li><code>&lt;font&gt;</code></li>
           <li><code>&lt;script&gt;</code></li>
+          <li><code>&lt;remove&gt;</code></li>
+          <li><code>&lt;attribute&gt;</code></li>
         </ul>
       </td>
       <td colspan="1" />

src/guides/v2.3/frontend-dev-guide/layouts/layout-types.md

@@ -229,13 +229,13 @@ To set attributes for the HTML `body` tag use the `<attribute>` instruction.
 **Example:** Add a new class to the `body` tag.
 
 ```xml
-<page>
     <body>
         <attribute name="class" value="my-new-body-class"/>
     </body>
-</page>
 ```
 
+![Block Class]({{ site.baseurl }}/common/images/body-class-result.png)
+
 **Example:** Add a custom attribute to the `body` tag.
 
 ```xml

src/guides/v2.3/frontend-dev-guide/layouts/xml-manage.md

@@ -221,32 +221,6 @@ Syntax option | Description
 `@doc(description)` | Describes the purpose of the mutation
 `@deprecated(reason: "description")` | Use `@deprecated` to mark a query, mutation, or attribute as deprecated
 
-{:.bs-callout-tip}
-It is a good practice to define separate types for input and output data. This practice permits additional extension points, so every input and output type can be extended by adding additional fields to the definition.
-
-#### Example
-
-**Wrong approach:**
-
-```text
-type Mutation {
-    mutationQueryName(param1: String, param2: Int, ...): MutationQueryOutput @resolver(class: "Magento\\<module_name>\\Model\\Resolver\\MutationResolverModel") @doc(description:"Mutation query description")
-}
-```
-
-**Correct approach:**
-
-```text
-type Mutation {
-    mutationQueryName(inputParam: InputParamsType): MutationQueryOutput @resolver(class: "Magento\\<module_name>\\Model\\Resolver\\MutationResolverModel") @doc(description:"Mutation query description")
-}
-
-type InputParamsType {
-    param1: String
-    param2: Int
-}
-```
-
 ### Resolver class
 
 Use the following sample code as a template for the GraphQL resolver mutation class: