Merge branch 'master' into db_mftf_testlist

Author: dobooth

_data/toc/cloud-guide.yml

@@ -208,6 +208,9 @@ pages:
       children:
         - label: Application
           url: /cloud/project/project-conf-files_magento-app.html
+          children:
+            - label: Set cache for static files
+              url: /cloud/project/set-cache.html
 
         - label: Build and deploy
           url: /cloud/project/magento-env-yaml.html
@@ -307,6 +310,9 @@ pages:
         - label: Manage branches with the CLI
           url: /cloud/env/environments-start.html
 
+        - label: Profile database queries
+          url: /cloud/project/profile-database-queries.html
+
         - label: Snapshots and backup management
           url: /cloud/project/project-webint-snap.html
 

_data/whats-new.yml

@@ -4,9 +4,55 @@ description: |
   We exclude from this list proofreading, spelling checks, and all minor updates.
 link: /whats-new.html
 thread: /whatsnew-feed.xml
-updated: Fri Jul 26 15:50:11 2019
+updated: Fri Aug 2 12:05:50 2019
 entries:
-- description: Updated changes in the 2.3.2 schema of the [customer endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/customer.htm).
+- description: Added information about patch PRODSECBUG-2233 to the relevant release
+    notes for affected Magento versions.
+  versions: 2.2.8, 2.2.x, 2.3.0, 2.3.1, 2.3.x, 2.x
+  type: Major update
+  date: August 2, 2019
+  link: https://github.com/magento/devdocs/pull/5091
+- description: Added the 'Backward Compatibility' section to the [Magento Definition
+    of Done](https://devdocs.magento.com/guides/v2.2/contributor-guide/contributing_dod.html).
+  versions: 2.3.x
+  type: Major update
+  date: July 31, 2019
+  link: https://github.com/magento/devdocs/pull/4801
+- description: "Updated the [Services topic](https://devdocs.magento.com/guides/v2.2/cloud/project/project-conf-files_services.html)
+    in the Cloud guide.<br/>-  Clarified the disk value requirements.<br/>-  Simplified the
+    [relationships property](https://devdocs.magento.com/guides/v2.2/cloud/project/project-conf-files_magento-app.html#relationships)
+    in the application configuration."
+  versions: 2.x
+  type: Technical changes
+  date: July 30, 2019
+  link: https://github.com/magento/devdocs/pull/5039
+- description: Added the new topic [CSS Critical Path](https://devdocs.magento.com/guides/v2.2/frontend-dev-guide/css-topics/css-critical-path.html)
+    to the Frontend Developer Guide.
+  versions: 2.2.x, 2.3.x
+  type: New topic
+  date: July 30, 2019
+  link: https://github.com/magento/devdocs/pull/4726
+- description: Added steps for [creating a patch from a git commit](https://devdocs.magento.com/guides/v2.2/comp-mgr/patching.html#custom-patches).
+  versions: 2.2.x, 2.3.x
+  type: Major update
+  date: July 29, 2019
+  link: https://github.com/magento/devdocs/pull/5056
+- description: Added a new section about [changing the Blackfire account owner](https://devdocs.magento.com/guides/v2.3/cloud/project/project-integrate-blackfire.html#change-account-owner)
+    on a Magento Commerce (Cloud) project.
+  versions: 2.2.x, 2.3.x
+  type: Major update
+  date: July 29, 2019
+  link: https://github.com/magento/devdocs/pull/5070
+- description: Updated the [Fastly Set up](https://devdocs.magento.com/guides/v2.3/cloud/cdn/configure-fastly.html)
+    instructions to remove the requirement to install the Fastly CDN module for Magento
+    2 in Magento Commerce Cloud environments. The latest version of the Fastly module
+    is installed by default in Pro Staging and Production environments, and in the
+    Starter Production (`master`) environment.
+  versions: 2.2.x
+  type: Major update
+  date: July 27, 2019
+  link: https://github.com/magento/devdocs/pull/5025
+- description: Updated changes in the 2.3.2 schema of the [customer endpoint](https://devdocs.magento.com/guides/v2.3/graphql/reference/customer.html).
   versions: 2.3.x
   type: Major update
   date: July 25, 2019
@@ -18,7 +64,7 @@ entries:
   type: Technical changes
   date: July 25, 2019
   link: https://github.com/magento/devdocs/pull/5023
-- description: Added the [Asynchronous and deferred operations](http://devdocs.magento.com/guides/v2.3/extension-dev-guide/async-operations.md)
+- description: Added the [Asynchronous and deferred operations](https://devdocs.magento.com/guides/v2.3/extension-dev-guide/async-operations.html)
     topic to the PHP Developer Guide.
   versions: 2.3.x
   type: Major update

_includes/contributor/labels.md

@@ -78,7 +78,7 @@ General labels include a variety of tasks and definitions for pull requests and
 * `help wanted` - Indicates the creator or author needs help with a decision, advice for resolving, and so on.
 * `triage wanted` - Indicates the issues are under triage. See this information to learn more about the [Triage Wanted program](https://github.com/magento/magento2/wiki/Triage-Wanted).
 
-### Issue Resolution Status
+### Issue resolution status
 {:.no_toc}
 
 Labels applied to issues through verification and completion. For details on the process, see [GitHub Issues Processing Workflow](https://github.com/magento/magento2/wiki/GitHub-Issues-Processing-Workflow).
@@ -101,7 +101,7 @@ Labels applied to issues through verification and completion. For details on the
 
 All [contributions to DevDocs](https://github.com/magento/devdocs/blob/master/.github/CONTRIBUTING.md) receive the following labels:
 
-* `New topic`- New file submissions for content that has never existed on devdocs
-* `Major update` - Significant updates to existing content, such as a new section or example
-* `Technical` - Updates to the code or processes that alter the technical content of the document
-* `Editorial` - Fixes for typos, grammatical inconsistencies, or minor rewrites to correct inaccuracies.
+* `New topic`- New topic submissions for content that has never existed on DevDocs such as tutorials, references, instructions, and so on
+* `Major update` - Significant original updates to existing content
+* `Technical` - Updates to the code or processes that alter the technical content of the document, such as code snippets, reference documentation, parameter names and values, and other relevant content
+* `Editorial` - Fixes for typos, grammatical inconsistencies, or minor rewrites to correct inaccuracies

_includes/contributor/rewards.md

@@ -76,7 +76,8 @@ Each PR can earn one of the following additional achievements. If you entered an
 
 Achievement | Points | Description
 | ------------ | --- | --- |
-New topic | 30 | New file submissions for content that has never existed on devdocs
-Major update | 20 | Significant updates to existing content, such as a new section or example
-Technical | 10 | Updates to code or processes that alter the technical content of the document
+New topic | 30 | New topic submissions for content that has never existed in DevDocs, such as tutorials, references, instructions, and other relevant content
+Major update | 20 | Significant updates to existing content
+Technical | 10 | Updates to code or processes that alter the technical content of the document, such as code snippets, reference documentation, parameter names and values, and other relevant content
 
+If the PR earns recognition for significant updates and additions to the documentation, it may also receive a Special Achievement label, which garners an additional 20 points.

_includes/layout/header-scripts.html

@@ -27,7 +27,7 @@
     {
       label: "PWA",
       name: "pwa-devdocs",
-      baseUrl: "https://magento-research.github.io/pwa-studio"
+      baseUrl: "https://magento.github.io/pwa-studio"
     },
     {
       label: "Order Management",

guides/v2.2/cloud/architecture/cloud-architecture.md

@@ -3,6 +3,8 @@ group: cloud-guide
 title: Magento Commerce Cloud architecture
 functional_areas:
   - Cloud
+redirect_from:
+  - /guides/v2.2/cloud/basic-information/cloud-plans.html
 ---
 
 {{site.data.var.ece}} has a Starter and a Pro plan. Each plan has a unique architecture to drive your {{site.data.var.ee}} development and deployment process. Both the Starter plan and the Pro plan architecture deploy databases, web server, and caching servers across multiple environments for end-to-end testing while supporting continuous integration.

guides/v2.2/cloud/cdn/configure-fastly.md

@@ -126,11 +126,11 @@ Fastly caching services do not work until you complete the initial upload of the
 {: .bs-callout-info}
 Before adding [custom](#custom-configuration) or advanced configuration settings like [updating purge settings](#purge) and configuring [Fastly image optimization]({{ page.baseurl }}/cloud/cdn/fastly-image-optimization.html)(Fastly IO), [verify]({{ page.baseurl }}/cloud/cdn/trouble-fastly.html) that the Fastly caching service works with the default configuration.
 
-Configure the following features and enable additional [configuration options](https://github.com/fastly/fastly-magento2/blob/master/Documentation/CONFIGURATION.md#further-configuration-options) as needed:
+Configure the following features as needed:
 
-* [Upload Fastly VCL snippets](#upload-vcl-snippets)
 * [Configure backends and Origin shielding](#backend)
 * [Customize response pages]({{ page.baseurl }}/cloud/cdn/cloud-fastly-custom-response.html)
+* [Enable additional Fastly configuration options](https://github.com/fastly/fastly-magento2/blob/master/Documentation/CONFIGURATION.md#further-configuration-options)
 
 ### Configure backends and Origin shielding {#backend}
 

guides/v2.2/cloud/docker/docker-config.md

@@ -77,6 +77,9 @@ For example, the following command starts the Docker configuration generator for
     ```bash
     echo "127.0.0.1 magento2.docker" | sudo tee -a /etc/hosts
     ```
+    
+    {: .bs-callout-tip }
+To change the `magento2.docker` hostname for your project, you must update the host in three files: `.docker/config.php`, `docker-compose.yml`, and `/etc/hosts`
 
 1.  Stop the default Apache instance on Mac OS.
 
@@ -204,7 +207,7 @@ The `{{site.data.var.ct}}` version 2002.0.18 and later supports developer mode.
 
 1.  _Optional_: Configure the Docker global variables in the `docker-compose.yml` file. For example, you can [enable and configure Xdebug]({{ page.baseurl }}/cloud/docker/docker-development-debug.html).
 
-1.  Start the file synchronization.
+1.  Start the file synchronization (use one of the following).
 
     For the `docker-sync` tool:
 

guides/v2.2/cloud/project/profile-database-queries.md

@@ -0,0 +1,70 @@
+---
+group: cloud-guide
+title: Profile database queries
+functional_areas:
+  - Cloud
+  - Setup
+  - Services
+---
+
+When making changes to a database, you may find it helpful to run profiling to identify the impact of those changes. Profiling maintains a log of database queries and increases run-time precision.
+
+#### To enable database query profiling:
+
+1. [Log in to the database]({{page.baseurl}}/cloud/env/environments-start.html#commands).
+
+1. Enable profiling.
+
+    ```sql
+    SET @@profiling = 1;
+    ... run some queries
+    ```
+
+1. Display the log of queries.
+
+    ```sql
+    SHOW profiles
+    ```
+
+1. Clear the profile queue.
+
+    ```sql
+    SET @@profiling = 0;
+    SET @@profiling_history_size = 0;
+    SET @@profiling_history_size = 100;
+    SET @@profiling = 1;
+    ```
+
+#### Example log
+
+{: .no-copy}
+```sql
+MariaDB [6fck2obu3244c]> show profiles;
++----------+------------+---------------------------------------------------------------------------------------------------------------------------------+
+| Query_ID | Duration   | Query                                                                                                                           |
++----------+------------+---------------------------------------------------------------------------------------------------------------------------------+
+|        2 | 0.00375905 | ALTER TABLE mcom_logged_messages_queue DROP INDEX status                                                                        |
+|        3 | 1.13660446 | CREATE INDEX `idx_status_direction` ON mcom_logged_messages_queue (status, direction)                                           |
+|        4 | 0.00270735 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|        5 | 0.00376312 | ALTER TABLE mcom_logged_messages_queue DROP INDEX status                                                                        |
+|        6 | 0.00585975 | ALTER TABLE mcom_logged_messages_queue DROP INDEX idx_status_direction                                                          |
+|        7 | 1.16887269 | CREATE INDEX `idx_status` ON mcom_logged_messages_queue (status)                                                                |
+|        8 | 0.00299303 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|        9 | 0.00379892 | ALTER TABLE mcom_logged_messages_queue DROP INDEX status                                                                        |
+|       10 | 0.00737345 | ALTER TABLE mcom_logged_messages_queue DROP INDEX idx_status                                                                    |
+|       11 | 1.05551113 | CREATE INDEX `idx_direction` ON mcom_logged_messages_queue (direction)                                                          |
+|       12 | 1.02493811 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|       13 | 0.00368751 | ALTER TABLE mcom_logged_messages_queue DROP INDEX status                                                                        |
+|       14 | 0.00706102 | ALTER TABLE mcom_logged_messages_queue DROP INDEX idx_direction                                                                 |
+|       15 | 0.29753293 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|       16 | 1.24034449 | CREATE INDEX `idx_direction` ON mcom_logged_messages_queue (direction)                                                          |
+|       17 | 0.74422050 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|       18 | 1.16976630 | CREATE INDEX `idx_status` ON mcom_logged_messages_queue (status)                                                                |
+|       19 | 0.00293179 | SELECT count(*) FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC |
+|       20 | 0.02663829 | SELECT * FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC        |
+|       21 | 0.00736756 | ALTER TABLE mcom_logged_messages_queue DROP INDEX idx_direction                                                                 |
+|       22 | 0.00406736 | ALTER TABLE mcom_logged_messages_queue DROP INDEX status                                                                        |
+|       23 | 0.00815528 | ALTER TABLE mcom_logged_messages_queue DROP INDEX idx_status                                                                    |
+|       24 | 0.37585821 | SELECT * FROM `mcom_logged_messages_queue` WHERE (status = 'FAILED') AND (direction = 'outgoing') ORDER BY `sent_at` ASC        |
++----------+------------+---------------------------------------------------------------------------------------------------------------------------------+
+```

guides/v2.2/cloud/project/project-conf-files_services-elastic.md

@@ -43,6 +43,18 @@ functional_areas:
 
 1. [Verify the relationships]({{page.baseurl}}/cloud/project/project-conf-files_services.html#service-relationships) and configure Elasticsearch in the Admin UI.
 
+1. Reindex the Catalog Search index.
+
+    ```bash
+    bin/magento indexer:reindex catalogsearch_fulltext
+    ```
+
+1. Clean the cache.
+
+    ```bash
+    bin/magento cache:clean
+    ```
+
 ### Add Elasticsearch plugins
 
 Optionally, you can add plugins with the `.magento/services.yaml` file. For example, to enable the ICU analysis plugin and Python script support plugin, add the `configuration:plugins` section with the listed plugin codes: