Merge branch 'master' into patch-27

Author: shrielenee

.gitignore

@@ -19,10 +19,14 @@
 !/_config.stage.yml
 
 *.bat
-*.sh
 /tmp/
-!/**/samples/*.sh
 /vendor/
 /node_modules/
 
 _algolia_api_key
+
+# Docs from different repositories #
+###################################
+
+/mbi/
+/page-builder/

Gemfile.lock

@@ -1,6 +1,6 @@
 GIT
   remote: https://github.com/magento-devdocs/devdocs-theme.git
-  revision: 1ce56765123d6c552ae1c251a0df924971269f89
+  revision: dcb189be6fd4e0ebc69dce7cd6cdeb3b960b3a9e
   specs:
     devdocs (0.0.1)
       jekyll (~> 3.3)

Rakefile

@@ -12,9 +12,9 @@ require 'launchy'
 require 'colorator'
 
 # Load ruby files with helper methods from the 'rakelib/' directory
-require_relative 'rakelib/link-checker.rb'
-require_relative 'rakelib/converter.rb'
-require_relative 'rakelib/double-slash-check.rb'
+require_relative 'rakelib/lib/link-checker.rb'
+require_relative 'rakelib/lib/converter.rb'
+require_relative 'rakelib/lib/double-slash-check.rb'
 
 desc "Same as 'rake', 'rake preview'"
 task default: %w[preview]
@@ -56,3 +56,6 @@ task build: %w[clean] do
   sh 'bundle exec jekyll build --verbose --trace'
   puts 'Built!'.green
 end
+
+desc 'Pull docs from external repositories'
+task init: %w[multirepo:init]

_config.yml

@@ -64,6 +64,14 @@ defaults:
     values:
       layout: video
 
+  - 
+    scope:
+      path: mbi
+    values:
+      group: mbi
+      github_files: https://github.com/magento/devdocs-mbi/blob/master/
+      github_repo: https://github.com/magento/devdocs-mbi/
+
   -
     scope:
       path: mftf/2.2
@@ -84,9 +92,7 @@ defaults:
     scope:
       path: page-builder
     values:
-      layout: default
       group: page-builder
-      strip_title: true
       github_link: false
       feedback_link: false
 
@@ -178,6 +184,10 @@ algolia:
     - guides/m1x/**/*.md
     - swagger
     - redoc
+  # Index HTML elements, especially code samples.
+  nodes_to_index: 'p,li,td,code'
+  # Override 10KB default and use our allowed max of 20KB
+  max_record_size: 20000
 
 google:
   analytics: UA-66243208-1

_data/main-nav.yml

@@ -100,7 +100,7 @@
         - label: Admin Style Guide
           url: /design-styleguide/bk-styleguide.html
 
-        - label: Magento PWA Documentation Site
+        - label: PWA Documentation Site
           url: https://magento-research.github.io/pwa-studio/
           include_versions: ['2.3']
 
@@ -124,9 +124,11 @@
           url: /marketplace/eqp/api.html
           exclude_versions: ['2.0']
 
-        - label: Magento BI Import REST API
-          url: https://developers.rjmetrics.com/
+        - label: Business Intelligence Import API
+          url: /mbi/docs/getting-started.html
           exclude_versions: ['2.0']
+          versionless: true
+
 
 - label: Testing
   children:

_data/toc/cloud-guide.yml

@@ -72,6 +72,9 @@ pages:
             - label: Launch Docker
               url: /cloud/docker/docker-config.html
 
+            - label: Configure Xdebug for Docker
+              url: /cloud/docker/docker-development-debug.html
+
             - label: Docker quick reference
               url: /cloud/docker/docker-quick-reference.html
 
@@ -172,22 +175,22 @@ pages:
           url: /cloud/cdn/fastly-image-optimization.html
           exclude_versions: ["2.0"]
 
-        - label: Custom Fastly VCL snippets
+        - label: Custom VCL snippets
           url: /cloud/cdn/cloud-vcl-custom-snippets.html
           exclude_versions: ["2.0"]
           children:
-            - label: Custom whitelist VCL
+            - label: Set up redirects to WordPress
+              url: /cloud/cdn/fastly-vcl-wordpress.html
+
+            - label: Block referral spam
+              url: /cloud/cdn/fastly-vcl-badreferer.html
+
+            - label: Secure access to the Magento Admin UI
               url: /cloud/cdn/fastly-vcl-whitelist.html
 
             - label: Custom blacklist VCL
               url: /cloud/cdn/fastly-vcl-blacklist.html
 
-            - label: Custom redirect to WordPress VCL
-              url: /cloud/cdn/fastly-vcl-wordpress.html
-
-            - label: Custom block bad referer VCL
-              url: /cloud/cdn/fastly-vcl-badreferer.html
-
         - label: Fastly troubleshooting
           url: /cloud/cdn/trouble-fastly.html
 

_data/toc/graphql.yml

@@ -79,6 +79,3 @@ pages:
 
             - label: urlResolver endpoint
               url: /graphql/reference/url-resolver.html
-
-            - label: Wishlist endpoint
-              url: /graphql/reference/wishlist.html

_data/toc/magento-functional-testing-framework-guide-2_3.yml

@@ -113,6 +113,10 @@ pages:
     url: /mftf/2.3/troubleshooting.html
     versionless: true
 
+  - label: Versioning
+    url: /mftf/2.3/versioning.html
+    versionless: true
+
   - label: Contribution guidelines
     url: https://github.com/magento/magento2-functional-testing-framework/blob/master/.github/CONTRIBUTING.md
     versionless: true

_data/toc/mbi.yml

@@ -0,0 +1,19 @@
+label: Business Intelligence
+url: /mbi/docs/
+versionless: true
+pages:
+- label: Getting started
+  url: /mbi/docs/getting-started.html
+  versionless: true
+
+- label: Import API
+  url: /mbi/docs/import-api.html
+  versionless: true
+
+- label: Cloud onboarding API
+  url: /mbi/docs/cloud-api.html
+  versionless: true
+
+- label: Libraries
+  url: /mbi/docs/libraries.html
+  versionless: true

_data/whats-new.yml

@@ -4,8 +4,117 @@ description: |
   We exclude from this list proofreading, spelling checks, and all minor updates.
 link: /whats-new.html
 thread: /whatsnew-feed.xml
-updated: Tue Feb 19 10:45:50 2019
+updated: Mon Mar  4 13:13:10 2019
 entries:
+- description: Added a section about [Required System Dependencies](http://devdocs.magento.com/guides/v2.3/install-gde/system-requirements-tech.html#required-system-dependencies)<br/>Added
+    a section about [Unsupported Operating Systems](http://devdocs.magento.com/guides/v2.3/install-gde/system-requirements-tech.html#unsupported-operating-systems)
+  versions: 2.3.x
+  type: Major update
+  date: March  4, 2019
+  link: https://github.com/magento/devdocs/pull/3864
+- description: Update [community contribution guidelines](https://devdocs.magento.com/guides/v2.3/contributor-guide/contributing.html#porting)
+    about porting
+  versions: 2.x
+  type: Major update
+  date: March  4, 2019
+  link: https://github.com/magento/devdocs/pull/3850
+- description: Fixed the incorrect `composer install` command in [Set up an Embedded
+    MFTF](https://devdocs.magento.com/mftf/2.3/getting-started.html#setup-framework).
+  versions: 2.3.x
+  type: Technical changes
+  date: March  4, 2019
+  link: https://github.com/magento/devdocs/pull/3863
+- description: Migrated the Magento Business Intelligence (MBI) [Import API documentation](https://devdocs.magento.com/mbi/docs/getting-started.html)
+    from the RJMetrics domain to the Magento domain.
+  versions: '2.x'
+  type: Major update
+  date: March  1, 2019
+  link: https://github.com/magento/devdocs/pull/3841
+- description: "-  Updated the [Custom VCL snippets](https://devdocs.magento.com/guides/v2.3/cloud/cdn/cloud-vcl-custom-snippets.html)
+    with instructions for using the Magento Admin UI to create and manage VCL snippets.<br/>-
+    \ Updated and corrected the following examples for using Fastly Edge Dictionaries
+    and custom VCL snippets to manage request routing for Magento Commerce Cloud traffic:
+    [Set up redirects to WordPress backend](https://devdocs.magento.com/guides/v2.3/cloud/cdn/fastly-vcl-wordpress.html),
+    [Block referrer spam](https://devdocs.magento.com/guides/v2.3/cloud/cdn/fastly-vcl-badreferer.html),
+    and [Secure access to the Admin UI by client IP address](https://devdocs.magento.com/guides/v2.3/cloud/cdn/fastly-vcl-whitelist.html).
+    Included prerequisites and instructions for  adding VCL snippets from the Admin
+    UI or Fastly API."
+  versions: 2.1.x, 2.2.x, 2.3.x
+  type: Technical changes
+  date: March  1, 2019
+  link: https://github.com/magento/devdocs/pull/3623
+- description: Updated the [GitHub integration topic](https://devdocs.magento.com/guides/v2.2/cloud/integrations/github-integration.html).
+  versions: 2.x
+  type: Technical changes
+  date: March  1, 2019
+  link: https://github.com/magento/devdocs/pull/3843
+- description: Updated example for requesting domain delegation when configuring Fastly
+    services for a Magento Commerce Cloud project. See [Multiple Fastly accounts and
+    assigned domains](https://devdocs.magento.com/guides/v2.3/cloud/cdn/configure-fastly.html#domain).
+  versions: 2.1.x, 2.2.x, 2.3.x
+  type: Technical changes
+  date: February 28, 2019
+  link: https://github.com/magento/devdocs/pull/3814
+- description: Update Commerce, PWA, and Page Builder [product availability](https://devdocs.magento.com/availability)
+  versions: 2.3.x
+  type: Major update
+  date: February 28, 2019
+  link: https://github.com/magento/devdocs/pull/3833
+- description: 'Updated the [Cloud Release notes for ece-tools version 2002.0.16.](http://devdocs.magento.com/guides/v2.3/cloud/release-notes/cloud-tools.html#v2002016)<br/>-
+    Updated the Cloud Docker content with information about using the [`sendmail`
+    service](http://devdocs.magento.com/cloud/docker/docker-development.html#sendmail-service).<br/>- Updated
+    the Cloud Docker content to explain how to [configure Xdebug](http://devdocs.magento.com/guides/v2.3/cloud/docker/docker-development-debug.html).<br/>-
+    Added two new environment variables: [RESOURCE_CONFIGURATION deploy variable](http://devdocs.magento.com/guides/v2.3/cloud/env/variables-deploy.html)
+    and [X_FRAME_CONFIGURATION global variable](http://devdocs.magento.com/guides/v2.3/cloud/env/variables-global.html)<br/>-
+    Updated the [ADMIN variables](https://devdocs.magento.com/guides/v2.3/cloud/env/environment-vars_magento.html)
+    and clarified the usage of ADMIN variables in the [Access your Magento Admin panel](https://devdocs.magento.com/guides/v2.3/cloud/onboarding/onboarding-tasks.html)
+    page.<br/>- Added an example for preloading pages from multiple domains in the
+    [WARM_UP_PAGES post-deploy variable](https://devdocs.magento.com/guides/v2.3/cloud/env/variables-post-deploy.html#warm_up_page).<br/>-
+    Deprecated SCD_EXCLUDE_THEMES environment variable.<br/>- Clarified the [backup
+    and retention](https://devdocs.magento.com/guides/v2.3/cloud/architecture/pro-architecture.html#backup-and-disaster-recovery)
+    statements regarding the most recent 24-hour period.'
+  versions: 2.1.x, 2.2.x, 2.3.x
+  type: Major update
+  date: February 26, 2019
+  link: https://github.com/magento/devdocs/pull/3788
+- description: Updated data types for Inventory Management [Check salable quantities](https://devdocs.magento.com/guides/v2.3/rest/modules/inventory/check-salable-quantity.html),
+    [Manage low-quantity notifications](https://devdocs.magento.com/guides/v2.3/rest/modules/inventory/manage-low-quantity.html),
+    [Manage source items](https://devdocs.magento.com/guides/v2.3/rest/modules/inventory/manage-source-items.html),
+    and [Manage source selection algorithms](https://devdocs.magento.com/guides/v2.3/rest/modules/inventory/manage-source-selection.html)
+  versions: 2.3.x
+  type: Technical changes
+  date: February 26, 2019
+  link: https://github.com/magento/devdocs/pull/3804
+- description: Removed improper git commands for composer reinstall in [Uninstall
+    and Reinstall Magento](https://devdocs.magento.com/guides/v2.3/install-gde/install/cli/install-cli-uninstall.html#instgde-install-magento-reinstall)
+    and links to correct instructions.
+  versions: 2.2.x, 2.3.x
+  type: Technical changes
+  date: February 22, 2019
+  link: https://github.com/magento/devdocs/pull/3802
+- description: Added the section [Merge action groups](http://devdocs.magento.com/mftf/2.3/merging.html#merge-action-groups)
+    to the Merging page in the MFTF guide.
+  versions: 2.3.x
+  type: Major update
+  date: February 21, 2019
+  link: https://github.com/magento/devdocs/pull/3792
+- description: Added the missing `cache` command in [Disable Module Output](https://devdocs.magento.com/guides/v2.2/config-guide/config/disable-module-output.html#export-the-configuration-changes).
+  versions: 2.2.x, 2.3.x
+  type: Technical changes
+  date: February 21, 2019
+  link: https://github.com/magento/devdocs/pull/3799
+- description: Added a [Versioning](https://devdocs.magento.com/mftf/2.3/versioning.html)
+    topic to the MFTF guide.
+  versions: 2.2.x, 2.3.x
+  type: Major update
+  date: February 21, 2019
+  link: https://github.com/magento/devdocs/pull/3781
+- description: Added information about testing strategies to the [Magento Testing
+    Guide](https://devdocs.magento.com/guides/v2.3/test/testing.html).
+  versions: 2.2.x, 2.3.x
+  type: Major update
+  date: February 20, 2019
+  link: https://github.com/magento/devdocs/pull/3791
 - description: Added [Use parameterized selectors in action groups with argument references](https://devdocs.magento.com/mftf/2.3/tips-tricks.html#use-parameterized-selectors-in-action-groups-with-argument-references)
     to Tips and Tricks.
   versions: 2.3.x

_includes/cloud/admin-ui-login-step.md

@@ -0,0 +1 @@
+1.  [Log in]({{ page.baseurl }}/cloud/onboarding/onboarding-tasks.html#admin) to the Magento Admin UI.

_includes/cloud/cloud-fastly-manage-vcl-from-admin.md

@@ -0,0 +1,39 @@
+## Modify the custom VCL snippet
+
+1.  [Log in]({{ page.baseurl }}/cloud/onboarding/onboarding-tasks.html#admin) to the Magento Admin UI.
+
+1.  Click **Stores** > **Settings** > **Configuration** > **Advanced** > **System**.
+
+1.  Expand **Full Page Cache** > **Fastly Configuration** > **Custom VCL Snippets**.
+
+    ![Manage custom VCL snippets]
+
+1.  In the _Action_ column, click the settings icon next to the snippet to edit.
+
+1.  After the page reloads, click **Upload VCL to Fastly** in the *Fastly Configuration* section.
+
+1.  After the upload completes, refresh the cache according to the notification at the top of the page.
+
+
+{: .bs-callout .bs-callout-warning}
+The *Custom VCL snippets* UI option shows only the snippets added through the Admin UI. You must use the Fastly API to [manage custom snippets added through the API]({{ page.baseurl }}/cloud/cdn/cloud-vcl-custom-snippets.html#manage-custom-vcl-snippets-using-the-api).
+
+
+## Delete the custom VCL snippet
+
+You can delete custom VCL snippet code from your Fastly configuration by uploading an empty version of the snippet from the Magento Admin UI, or delete it completely using the Fastly API.
+
+- Upload an empty version of the snippet file to Fastly to remove the VCL logic from the active VCL version:
+
+	- Edit the snippet and delete the **VCL** snippet content.
+
+	- Save the configuration.
+
+	- Upload the VCL to Fastly to apply your changes.
+	
+- Use the Fastly API [Delete custom VCL snippet]({{ page.baseurl }}/cloud/cdn/cloud-vcl-custom-snippets.html#manage-vcl) operation 
+ to delete the snippet completely, or submit a Magento support ticket to request deletion.
+
+
+[Manage custom VCL snippets]: {{site.baseurl}}/common/images/cloud/cloud-fastly-manage-snippets.png
+{: width="650px"}

_includes/layout/footer-scripts.html

@@ -28,8 +28,3 @@
 <script type="text/javascript">_satellite.pageBottom();</script>
 
 {% endif %}
-
-
-{% if page.url contains "cloud/" %}
-<script type="text/javascript" src="{{ site.baseurl }}/common/js/survey.js"></script>
-{% endif %}

_includes/layout/page-info.html

@@ -13,7 +13,7 @@
 
     {% if page.github_link %}
     <div class="github-link">
-      <a class="improve-page" href="{{ page.github_files }}{{ page.path }}" target="_blank" rel="noopener">
+      <a class="improve-page" href="{{ page.github_files }}{{ page.github_path }}" target="_blank" rel="noopener">
         Edit this page on GitHub
       </a>
     </div>

_plugins/algolia.rb

@@ -0,0 +1,12 @@
+module Jekyll
+  module Algolia
+    module Hooks
+      def self.before_indexing_each(record, node, context)
+        # Do not index records larger than 20000 bytes
+        return nil if record.to_s.bytesize > 20000
+        
+        record
+      end
+    end
+  end
+end