Merge branch 'master' into cli-short-command-name

Author: dshevtsov

.github/CONTRIBUTING.md

@@ -71,14 +71,14 @@ The following guidelines may answer most of your questions and help you get star
         For example:
 
         ```bash
-        git rm guides/v2.2/install-gde/composer.md
+        git rm guides/v2.3/install-gde/composer.md
         ```
 
         ```bash
-        cp guides/v2.1/install-gde/composer.md guides/v2.2/install-gde/composer.md
+        cp guides/v2.2/install-gde/composer.md guides/v2.3/install-gde/composer.md
         ```
 
-- Make sure that you update the correct version(s) of documentation (v2.1, v2.2, v2.3). If you are not sure what directory to put your content in, just do your best. We can help re-locate it (if necessary) during the review process.
+- Make sure that you update the correct version(s) of documentation (v2.2, v2.3). If you are not sure what directory to put your content in, just do your best. We can help re-locate it (if necessary) during the review process.
 - Review your work for basic typos, formatting errors, or ambiguous sentences before opening a pull request.
 - Revise pull requests according to review feedback. We will close pull requests that require an inordinate amount of time to review and process (especially for minor changes) if you fail to make revisions according to review feedback.
 - Do not directly contact DevDocs team members or maintainers on Slack to review your pull request unless it has been open for more than five days. We have a process and queue for pull requests that everyone must follow.
@@ -105,11 +105,11 @@ _(Optional)_ To review your changes in HTML output, follow the instructions in t
 
 We provide templates to help you get started writing new content and understanding Markdown formatting:
 
-- **General topic template** - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.1/contributor-guide/templates/basic_template.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/basic_template.html): This is a template for writing any topic with example formats and styles.
+- **General topic template** - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.3/contributor-guide/templates/basic_template.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/basic_template.html): This is a template for writing any topic with example formats and styles.
 - **Tutorial templates**: These templates provide example formats and styles for step-by-step instructions (like how-tos). Each file adds navigation buttons when content is generated. Templates include:
-  - First introduction topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.1/contributor-guide/templates/tutorial-template-first.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-first.html): Introduction to a tutorial for prerequisites and listing steps
-  - Middle topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.1/contributor-guide/templates/tutorial-template-middle.md) |  [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-middle.html): Use for each step in a tutorial.
-  - Final step topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.1/contributor-guide/templates/tutorial-template-last.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-last.html): Use for the last step of the tutorial.
+  - First introduction topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.3/contributor-guide/templates/tutorial-template-first.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-first.html): Introduction to a tutorial for prerequisites and listing steps
+  - Middle topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.3/contributor-guide/templates/tutorial-template-middle.md) |  [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-middle.html): Use for each step in a tutorial.
+  - Final step topic - [Markdown](https://github.com/magento/devdocs/blob/master/guides/v2.3/contributor-guide/templates/tutorial-template-last.md) | [HTML](https://devdocs.magento.com/guides/v2.3/contributor-guide/templates/tutorial-template-last.html): Use for the last step of the tutorial.
 
 ### Edit metadata
 

.gitignore

@@ -33,3 +33,4 @@ _algolia_api_key
 ###################################
 
 /guides/v2.0/
+/guides/v2.1/

README.md

@@ -13,7 +13,6 @@ Our goal is to provide the Magento community with comprehensive and quality tech
 You can build this site locally in the following ways:
 
 - [Installing the project dependencies locally](#build-using-jekyll) (Mac, Linux)
-
 - [Using a Vagrant virtual machine](#build-using-vagrant) (Mac, Linux, Windows)
 - [Build DevDocs in Windows](#build-devdocs-in-windows) (Windows 7 & 10)
 
@@ -178,6 +177,38 @@ To build v2.0 documentation:
     rake preview
     ```
 
+### To build v2.1 documentation
+
+Magento 2.1.18 was the final 2.1.x release. After June 2019, Magento 2.1.x stopped receiving security patches, quality fixes, and documentation updates.
+
+To ensure the quality of our public documentation for versions of Magento that are still supported and to avoid potential confusion about 2.1.x support, we removed all 2.1.x content from our public documentation websites on July 11, 2019.
+
+To build v2.1 documentation:
+
+> Also, you can use the GitHub interface to read the source Markdown files instead of building the site locally. Navigate to the [`2.1`](https://github.com/magento/devdocs/tree/2.1) branch and click the file you want to view.
+
+1. Add an entry for 2.1 in the `Docfile.yml` file.
+
+    ```yaml
+    -
+      directory: guides/v2.1
+      repository: magento/devdocs
+      branch: 2.1
+      filter: false
+    ```
+
+1. Initialize the `2.1` branch in your local devdocs repository.
+
+    ```shell
+    rake init
+    ```
+
+1. Run the preview command.
+
+    ```shell
+    rake preview
+    ```
+
 ## Build using Vagrant
 
 You can deploy the devdocs site locally using [this Vagrant project](https://github.com/magento-devdocs/vagrant-for-magento-devdocs).

_config.yml

@@ -19,9 +19,6 @@ baseurl: ""
 #
 version: "2.3"
 versions:
-   -
-      name: "2.1"
-      url: /guides/v2.1/
    -
       name: "2.2"
       url: /guides/v2.2/
@@ -102,11 +99,7 @@ defaults:
       group: module-reference-guide-2_3
       github_link: false
       feedback_link: false
-  -
-    scope:
-      path: guides/v2.1
-    values:
-      sitemap: false
+
   -
     scope:
       path: guides/v2.2
@@ -197,10 +190,6 @@ mage2bloburl: https://github.com/magento/magento2/blob
 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/
-
 # 2.2 variables
 gdeurl22: /guides/v2.2/
 githuburl22: https://github.com/magento/devdocs/tree/master/guides/v2.2/

_data/toc/javascript-developer-guide.yml

@@ -90,3 +90,6 @@ pages:
 
         - label: Tabs widget
           url: /javascript-dev-guide/widgets/widget_tabs.html
+
+        - label: ToggleAdvanced widget
+          url: /javascript-dev-guide/widgets/widget_toggle.html

_data/toc/ui-components-guide.yml

@@ -25,6 +25,10 @@ pages:
         - label: Checkboxset component
           url: /ui_comp_guide/components/ui-checkboxset.html
 
+        - label: ColorPicker component
+          include_versions: ["2.3"]
+          url: /ui_comp_guide/components/ui-colorpicker.html
+
         - label: Column component
           url: /ui_comp_guide/components/ui-column.html