Merge branch 'master' into 2.1.16-release-notes

Author: jfrontain

_config.checks.yml

@@ -14,12 +14,8 @@ html-proofer:
     :in_processes: 3
   :file_ignore:
   - !ruby/regexp /guides\/m1x/
-  - !ruby/regexp /magento-techbull\.html/
-  - !ruby/regexp /swagger/
   - !ruby/regexp /template\.html/
   - !ruby/regexp /videos/
   - !ruby/regexp /whats-new\.html/
   :url_ignore:
-  - !ruby/regexp /guides\/v2\.0/
-  # - !ruby/regexp /mrg/
-  
+  - !ruby/regexp /guides\/v2\.0/

_config.yml

@@ -1,19 +1,22 @@
-# Site settings
-encoding: "utf-8"
+# This file contains configuration settings for the devdocs website.
+# Each setting is available on pages using Liquid {{ site.<config key> }}. For example, {{ site.title }}.
+# For more details about available options and defaults, refer to https://jekyllrb.com/docs/configuration/
+#
 title: Magento 2 Developer Documentation
 logo: DevDocs
-email: mailto:DL-Magento-Doc-Feedback@magento.com
-description: > # this means to ignore newlines until "baseurl:"
-  Magento 2 Developer Documentation.
-baseurl: ""
-url: "https://devdocs.magento.com" # the base hostname & protocol for your site
-# twitter_username: magento
-# github_username:  magento
+description: Magento 2 Developer Documentation.
+
+# the base protocol and domain
+url: https://devdocs.magento.com
+
+# Site theme. https://jekyllrb.com/docs/themes/
 theme: devdocs
 
-markdown_ext: "markdown,mkdown,mkdn,mkd,md"
+# Base url that forms 
+baseurl: ""
 
-# Version Switcher. Version numbers should be STRING
+# Parameters for the version switcher. Numeric values must be wraped in quotes.
+#
 version: "2.2"
 versions:
    -
@@ -29,62 +32,29 @@ versions:
       name: "2.3"
       url: /guides/v2.3/
 
-# GitHub variables
-
-mage2bloburl: "https://github.com/magento/magento2/blob/"
-
-# 2.0.0 variables
-gdeurl: "/guides/v2.0/"
-githuburl: "https://github.com/magento/devdocs/tree/develop/guides/v2.0/"
-mage2000url: "https://github.com/magento/magento2/blob/2.0/"
-
-# 1.x variables
-m1xgdeurl: "/guides/m1x/"
-m1xgithuburl: "https://github.com/magento/devdocs/blob/develop/"
-
-# 2.1.0 variables
-gdeurl21: "/guides/v2.1/"
-githuburl21: "https://github.com/magento/devdocs/tree/develop/guides/v2.1/"
-mage2100url: "https://github.com/magento/magento2/blob/2.1/"
-
-# 2.2.0 variables
-gdeurl22: "/guides/v2.2/"
-githuburl22: "https://github.com/magento/devdocs/tree/develop/guides/v2.2/"
-mage2200url: "https://github.com/magento/magento2/blob/2.2/"
-
-# 2.3.0 variables
-gdeurl23: "/guides/v2.3/"
-githuburl23: "https://github.com/magento/devdocs/tree/develop/guides/v2.3/"
-mage2300url: "https://github.com/magento/magento2/blob/2.3-develop/"
-
-# Other variables
-namem2fedg: "Magento 2 Frontend Developer's Guide"
-namem2devgde: "Magento 2 Developer's Guide"
-namem2apiref: "Magento 2 API Reference"
-namem2install: "Magento 2 Installation Guide"
-
-
 collections:
   videos:
     output: true
     permalink: "/videos/:path/"
 
-plugins:
-  - jekyll-redirect-from
-  - jekyll-titles-from-headings
-
+# Specific settings for different scopes.
+#
 defaults:
 
   -
     scope:
       path: ""
     values:
       layout: default
-      github_repo: "https://github.com/magento/devdocs/"
-      github_files: "https://github.com/magento/devdocs/blob/master/"
+      github_repo: https://github.com/magento/devdocs/
+      github_files: https://github.com/magento/devdocs/blob/master/
+      # Enables the 'Edit this page on GitHub' appearences on pages
+      github_link: true
+      # Enables the 'Give us feedback' appearences on pages
+      feedback_link: true
   -
     scope:
-      path: "guides/m1x"
+      path: guides/m1x
     values:
       layout: null
   -
@@ -95,58 +65,113 @@ defaults:
 
   -
     scope:
-      path: "mftf/2.2"
+      path: mftf/2.2
     values:
       group: magento-functional-testing-framework-guide
       functional_areas:
         - Test
 
   -
     scope:
-      path: "mftf/2.3"
+      path: mftf/2.3
     values:
       group: magento-functional-testing-framework-guide-2_3
       functional_areas:
         - Test
 
   -
     scope:
-      path: "guides/v2.3/mrg"
+      path: guides/v2.3/mrg
     values:
       group: module-reference-guide-2_3
       github_link: false
       feedback_link: false
 
+##########################
+# Plugins and extensions #
+##########################
+#
+# For more details about plugins, refer to https://jekyllrb.com/docs/plugins/
+# To learn more about particular plugin, find it by name on GitHub.
+# This list doesn't include custom plugins.
+#
+plugins:
+  - jekyll-redirect-from
+  - jekyll-titles-from-headings
+
+# Settings for the jekyll-titles-from-headings plugin.
+# For more details about the plugin, refer to https://github.com/benbalter/jekyll-titles-from-headings
+#
 titles_from_headings:
   enabled:     true
   strip_title: true
   collections: false
 
-# Build settings
-markdown: kramdown
-highlighter: rouge
+# kramdown parser settings (extended Markdown to HTML parser). For more details about available options, refer to https://kramdown.gettalong.org/converter/html.html
+#
 kramdown:
   toc_levels: 2..3
   syntax_highlighter_opts:
-    css_class: 'highlighter'
-
-incremental: false
+    css_class: highlighter
 
+# LiveReload monitors changes in the file system and refreshes browser when Jekyll is in serving mode.
+# http://livereload.com/
+#
 livereload: true
 
+# Search engine settings. For more details, refer to https://github.com/algolia/jekyll-algolia
+#
 algolia:
-  application_id: 'E642SEDTHL'
-  index_name: 'devdocs'
-  api_key: 'd2d0f33ab73e291ef8d88d8b565e754c'
+  application_id: E642SEDTHL
+  index_name: devdocs
+  api_key: d2d0f33ab73e291ef8d88d8b565e754c
   files_to_exclude:
     - guides/m1x/**/*.html
     - guides/m1x/**/*.md
     - swagger
     - redoc
 
 google:
-  analytics: 'UA-66243208-1'
+  analytics: UA-66243208-1
 
+#############
+# Variables #
+#############
+#
+# Magento 2 repository variable
+mage2bloburl: https://github.com/magento/magento2/blob/
+
+# 2.0 variables
+gdeurl: /guides/v2.0/
+githuburl: https://github.com/magento/devdocs/tree/master/guides/v2.0/
+mage2000url: https://github.com/magento/magento2/blob/2.0/
+
+# 1.x variables
+m1xgdeurl: /guides/m1x/
+m1xgithuburl: https://github.com/magento/devdocs/blob/master/
+
+# 2.1 variables
+gdeurl21: /guides/v2.1/
+githuburl21: https://github.com/magento/devdocs/tree/master/guides/v2.1/
+mage2100url: https://github.com/magento/magento2/blob/2.1/
+
+# 2.2 variables
+gdeurl22: /guides/v2.2/
+githuburl22: https://github.com/magento/devdocs/tree/master/guides/v2.2/
+mage2200url: https://github.com/magento/magento2/blob/2.2/
+
+# 2.3 variables
+gdeurl23: /guides/v2.3/
+githuburl23: https://github.com/magento/devdocs/tree/master/guides/v2.3/
+mage2300url: https://github.com/magento/magento2/blob/2.3-develop/
+
+
+##########
+# Ignore #
+##########
+#
+# The path patterns excluded during site generation
+#
 exclude:
   - scss
   - bin
@@ -162,4 +187,4 @@ exclude:
   - Rakefile
   - rakelib
   - README.md
-  - _plugins
+  - _plugins

_data/toc/graphql.yml

@@ -61,12 +61,19 @@ pages:
 
         - label: Other objects
           children:
+
+            - label: CMS endpoints
+              url: /graphql/reference/cms.html
+              
             - label: CustomAttributeMetadata endpoint
               url: /graphql/reference/custom-attribute-metadata.html
 
             - label: Customer endpoint
               url: /graphql/reference/customer.html
 
+            - label: Quote endpoint
+              url: /graphql/reference/quote.html
+
             - label: storeConfig endpoint
               url: /graphql/reference/store-config.html
 

common/css/devdocs.css

@@ -14,7 +14,7 @@ functional_areas:
 
 To extend an existing configuration type, you need only create a configuration file in your {% glossarytooltip c1e4242b-1f1a-44c3-9d72-1d5b1435e142 %}module{% endglossarytooltip %}.
 
-For example, to add an event observer, you create `app/etc/events.xml` and declare a new observer.
+For example, to add an event observer, you create `app/code/{VendorName}/{ModuleName}/etc/events.xml` and declare a new observer.
 
 Because the event configuration type already exists in Magento, the loader and the `events.xsd` validating schema are already present and functional.
 

guides/v2.0/config-guide/config/config-create.md

@@ -20,9 +20,9 @@ Some restrictions in the core {{site.data.var.ee}} code base prevent you from up
 | --- | --- |
 | 2.1.3 and earlier | You must upgrade to version 2.1.4 or later before you continue. |
 | 2.1.4 and later | You can begin the upgrade to [{{site.data.var.ct}} 2002.0.9]({{ page.baseurl }}/cloud/release-notes/cloud-tools.html#v200209) and later. |
-| 2.2.x | You can begin the upgrade to [{{site.data.var.ct}} 2002.0.8]({{ page.baseurl }}/cloud/release-notes/cloud-tools.html#v200208) and later. |
+| 2.2.x | You can begin the upgrade to [{{site.data.var.ct}} 2002.0.8]({{ page.baseurl }}/cloud/release-notes/cloud-release-archive.html#v200208) and later. |
 
 {: .bs-callout .bs-callout-info}
-We combined the upgrade metapackages for tools and patches with the release of [{{site.data.var.ct}} version 2002.0.8](http://devdocs.magento.com/guides/v2.2/cloud/release-notes/cloud-tools.html#v200208) to simplify the process for future updates.
+We combined the upgrade metapackages for tools and patches with the release of [{{site.data.var.ct}} version 2002.0.8](http://devdocs.magento.com/guides/v2.2/cloud/release-notes/cloud-release-archive.html#v200208) to simplify the process for future updates.
 
 {% include cloud/note-ece-tools-package.md %}