Merge branch 'live' into patch-1

Author: mattwojo

.openpublishing.redirection.json

@@ -3,7 +3,7 @@
     {
       "source_path": "wsl/install_guide.md",
       "redirect_url": "/windows/wsl/install-win10",
-      "redirect_document_id": true
+      "redirect_document_id": false
     },
     {
       "source_path": "wsl/user_support.md",
@@ -16,9 +16,24 @@
       "redirect_document_id": true
     },
     {
-      "source_path": "WSL/index.md",
-      "redirect_url": "about",
+      "source_path": "wsl/initialize-distro.md",
+      "redirect_url": "install-win10",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "wsl/wsl2-ux-changes.md",
+      "redirect_url": "compare-versions",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "wsl/wsl2-install",
+      "redirect_url": "install-win10",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "wsl/wsl2-install",
+      "redirect_url": "install-win10",
       "redirect_document_id": false
     }
   ]
-}
+}

README.md

@@ -6,13 +6,13 @@ If you find doc issues / errors or have an improvement you'd like to suggest, pl
 > **Note:** This repo's issue tracker is only for reporting issues with the WSL docs.
 > Other related issue repo's:
 > * WSL: https://github.com/Microsoft/WSL/
-> * Windows Console: https://github.com/Microsoft/Console/
+> * Windows Console: https://github.com/Microsoft/Terminal/
 
 ## External Links
 
 [Rendered documentation website](https://docs.microsoft.com/windows/wsl/) 
 
-[Release notes for WSL](https://docs.microsoft.com/en-us/windows/wsl/release-notes)
+[Release notes for WSL](https://docs.microsoft.com/windows/wsl/release-notes)
 
 ## Microsoft Open Source Code of Conduct
 

ThirdPartyNotices

@@ -9,7 +9,7 @@ may be either trademarks or registered trademarks of Microsoft in the United Sta
 The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
 Microsoft's general trademark guidelines can be found at https://go.microsoft.com/fwlink/?LinkID=254653.
 
-Privacy information can be found at https://privacy.microsoft.com/en-us/
+Privacy information can be found at https://privacy.microsoft.com/
 
 Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents,
 or trademarks, whether by implication, estoppel or otherwise.

WSL/TOC.md

@@ -1,46 +1,61 @@
 ---
-title: Learn about the Windows Subsystem for Linux
-description: Learn more about how the Windows Subsystem for Linux works.
+title: An overview on the the Windows Subsystem for Linux
+description: Learn about the Windows Subsystem for Linux, the different versions and ways you can use them.
 keywords: BashOnWindows, bash, wsl, windows, windowssubsystem, gnu, linux
-ms.date: 07/11/2016
+ms.date: 05/12/2020
 ms.topic: article
 ms.assetid: 3cefe0db-7616-4848-a2b6-9296746a178b
-ms.custom: seodec18
 ms.localizationpriority: high
 ---
 
-# Windows Subsystem for Linux Documentation
+# What is the Windows Subsystem for Linux?
 
-The Windows Subsystem for Linux lets developers run a GNU/Linux environment -- including most command-line tools, utilities, and applications -- directly on Windows, unmodified, without the overhead of a virtual machine.  
+The Windows Subsystem for Linux lets developers run a GNU/Linux environment -- including most command-line tools, utilities, and applications -- directly on Windows, unmodified, without the overhead of a virtual machine.
 
 You can:
 
-1. Choose your favorite GNU/Linux distributions [from the Microsoft Store](https://aka.ms/wslstore).
-1. Run common command-line free software such as `grep`, `sed`, `awk`, or other ELF-64 binaries. 
-1. Run Bash shell scripts and GNU/Linux command-line applications including:  
+* Choose your favorite GNU/Linux distributions [from the Microsoft Store](https://aka.ms/wslstore).
+* Run common command-line tools such as `grep`, `sed`, `awk`, or other ELF-64 binaries.
+* Run Bash shell scripts and GNU/Linux command-line applications including:  
     * Tools: vim, emacs, tmux
-    * Languages: Javascript/node.js, Ruby, Python, C/C++, C# & F#, Rust, Go, etc.
-    * Services: sshd, MySQL, Apache, lighttpd
-1. Install additional software using own GNU/Linux distribution package manager.
-1. Invoke Windows applications using a Unix-like command-line shell.
-1. Invoke GNU/Linux applications on Windows.
+    *Languages: [NodeJS](https://docs.microsoft.com/windows/nodejs/setup-on-wsl2), Javascript, [Python](https://docs.microsoft.com/windows/python/web-frameworks), Ruby, C/C++, C# & F#, Rust, Go, etc.
+    *Services: SSHD, MySQL, Apache, lighttpd, [MongoDB](https://docs.microsoft.com/windows/nodejs/databases), [PostgreSQL](https://docs.microsoft.com/windows/python/databases).
+* Install additional software using own GNU/Linux distribution package manager.
+* Invoke Windows applications using a Unix-like command-line shell.
+* Invoke GNU/Linux applications on Windows.
 
-## Getting Started
+## What is WSL 2?
 
-* [Install Linux on Windows 10](install-win10.md)
-* [Visit the command reference](reference.md)
-* [Read frequently asked questions](faq.md)
+WSL 2 is a new version of the Windows Subsystem for Linux architecture that powers the Windows Subsystem for Linux to run ELF64 Linux binaries on Windows. Its primary goals are to **increase file system performance**, as well as adding **full system call compatibility**.
 
-## Team Blogs
-*  [Overview post with a collection of videos and blogs](https://blogs.msdn.microsoft.com/commandline/learn-about-windows-console-and-windows-subsystem-for-linux-wsl/)
-* [Command-Line blog](https://blogs.msdn.microsoft.com/commandline/) (Active)
-* [Windows Subsystem for Linux Blog](https://blogs.msdn.microsoft.com/wsl/) (Historical)
+This new architecture changes how these Linux binaries interact with Windows and your computer's hardware, but still provides the same user experience as in WSL 1 (the current widely available version).
 
-## Posts & Articles
-* [Run Bash on Ubuntu on Windows](https://blogs.windows.com/buildingapps/2016/03/30/run-bash-on-ubuntu-on-windows/)
-* [Developers Can Run Bash And Usermode Ubuntu Linux Binaries On Windows 10](https://www.hanselman.com/blog/DevelopersCanRunBashShellAndUsermodeUbuntuLinuxBinariesOnWindows10.aspx)
-* [Ubuntu on Windows – The Ubuntu Userspace for Windows Developers](https://insights.ubuntu.com/2016/03/30/ubuntu-on-windows-the-ubuntu-userspace-for-windows-developers/) 
+Individual Linux distributions can be run with either the WSL 1 or WSL 2 architecture. Each distribution can be upgraded or downgraded at any time and you can run WSL 1 and WSL 2 distributions side by side. WSL 2 uses an entirely new architecture that benefits from running a real Linux kernel.
 
-## Provide Feedback
-* [GitHub issue tracker](https://github.com/Microsoft/BashOnWindows/issues)
+## Next steps
 
+* [Install WSL 1 and update to WSL 2](./install-win10.md)
+
+* [Compare WSL 2 and WSL 1](./compare-versions.md)
+
+* [Create a user account and password for your new Linux distribution](./user-support.md)
+
+* [Read Frequently Asked Questions](./faq.md)
+
+* [Read Frequently Asked Questions about WSL 2](./wsl2-faq.md)
+
+* [Troubleshooting](./troubleshooting.md)
+
+* [Run interoperability commands between Windows and Linux](./interop.md)
+
+* [Run launch commands and configurations](./wsl-config.md)
+
+* [Set up file permissions](./file-permissions.md)
+
+* [Set up WSL for Enterprise](./enterprise.md)
+
+* [Reference WSL commands](./reference.md)
+
+* [Build a custom distributions](./build-custom-distro.md)
+
+* [Read the WSL Release Notes](./release-notes.md)