Update home, sidebar. Add installation page.

Home.md

@@ -1,27 +1,53 @@
 The Docker extension makes it easy to build, manage and deploy containerized applications from Visual Studio Code. 
 
-# Prerequisites and installation
+> See [[Prerequisites and installation|Installation]] page for installation instructions.
 
-Install [Docker](https://docs.docker.com/install/) on your machine and add it to the system path.
+This page provides an overview of the Docker extension capabilities; use the side menu to learn more about topics of interest.
 
-On Linux, you should also [enable Docker CLI for the non-root user account](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) that will be used to run VS Code.
+## Editing Docker files
 
-To install the extension, open Extensions view (`Ctrl+Shift+X`), search for `docker` to filter results and select Docker extension authored by Microsoft.
+Rich IntelliSense (completions) are provided for `Dockerfile` and `docker-compose.yml` files:
 
-# Features
+[[images/home-dockerfile-intellisense.png|alt=IntelliSense for Dockerfiles]]
 
-The Docker extension can be used to:
+In addition, common errors for `Dockerfile` and `docker-compose.yml` files are detected and reported in the Problems panel.
 
-- Examine and modify Docker containers, images, networks and volumes.
-- Access frequently-used Docker commands directly from VS Code command palette (e.g. run images, launch container shell, view container logs, spin up and down Docker Compose services, and more).
-- Author Docker and Docker Compose files (with completion and linting).
-- Generate Docker and Docker Compose files for current workspace.
-- Work with container registries (e.g. Docker Hub or Azure Container Registry).
-- Deploy images from container registry to Azure App Service.
-- Debug services running inside a container (currently supported for .NET- and Node.js-based services).
+## Generating Docker files
 
-Use the side menu to learn more about all capabilities of the Docker extension.
+`Docker: Add Docker Files to Workspace` command will generate `Dockerfile`, `docker-compose.yml`, `docker-compose.debug.yml` and `.dockerignore` files to your workspace. The extension recognizes workspaces that use most popular development languages (C#, Node.js, Python, Ruby, Go and Java) and customizes Docker files accordingly.
 
+## Docker view
 
-> Maintaining good quality documentation is a priority for the Docker extension team. If you find missing or inaccurate content, or if you'd like to extend the wiki with a topic or tutorial, please let us know by opening an issue.
+The Docker extension contributes a Docker view to VS Code. The Docker view lets you examine and manage Docker assets: containers, images, volumes, networks, and container registries. If the Azure Account extension is installed, you can browse your Azure Container Registries as well.
 
+The right-click menu provides access to commonly-used commands for each type of asset.
+
+[[images/home-docker-view-context-menu.gif|alt=Docker view context menu]]
+
+You can rearrange the Docker view panes by dragging them up or down with a mouse and use the context menu to hide or show them.
+
+[[images/home-docker-view-rearrange.gif|alt=Customize Docker view]]
+
+## Docker commands
+
+Many of the most common Docker commands are built right into the Command Palette:
+
+[[images/home-command-palette.png|alt=Docker commands]]
+
+Covered areas include images, networks, volumes, container registries and Docker Compose. In addition, the `Docker: Prune System` custom command will remove stopped containers, dangling images, and unused networks and volumes.
+
+## Using container registries
+
+You can display the content and push/pull/delete images from Docker Hub and Azure Container Registries:
+
+[[images/home-container-registry.png|alt=Azure Container Registry content]]
+
+An image in an Azure Container Registry can be deployed to Azure App Service directly from VS Code—see [[Deploy images to Azure App Service|App-Service]] page. For more information about how to authenticate to and work with registries see [[Work with container registries|Quickstart-Container-Registries]] page. 
+
+## Debugging services running inside a container
+
+Services build using .NET (C#) and Node.js can be debugged when running inside a container. The extension offers custom tasks that help with launching a service under the debugger and with attaching the debugger to a running service instance. For more information see [[Debug container application|Quickstart-Debugging]]  and [[Customize container build and execution with tasks|Tasks]] pages.
+
+## Azure CLI integration
+
+The extension adds `Docker Images: Run Azure CLI` command that launches Azure CLI inside a standalone, Linux-based Docker container. This allows access to full Azure CLI command set in an isolated environment. See [Get started with Azure CLI](https://docs.microsoft.com/cli/azure/get-started-with-azure-cli?view=azure-cli-latest#sign-in) page for more information on available commands.

Installation.md

@@ -0,0 +1,7 @@
+[Install Docker](https://docs.docker.com/install/) on your machine and add it to the system path.
+
+On Linux, you should also [enable Docker CLI for the non-root user account](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) that will be used to run VS Code.
+
+To install the extension, open Extensions view (`Ctrl+Shift+X`), search for `docker` to filter results and select Docker extension authored by Microsoft.
+
+[[images/installation-extension-search.png|alt=Select Docker extension]]

_Footer.md

@@ -0,0 +1 @@
+Maintaining good quality documentation is a priority for the Docker extension team. If you find missing or inaccurate content, or if you'd like to extend the wiki with a topic or tutorial, please let us know [by opening an issue](https://github.com/microsoft/vscode-docker/issues).

_Sidebar.md

@@ -1,21 +1,18 @@
 ## [[Home]]
 
-* [[About Docker extension|Overview]]
+* [[Prerequisites and installation|Installation]]
+* [[Choosing development environment for containers|Choosing-Development-Environment]]
 
 ## Quickstarts
 
-* [[Work with images and containers|Quickstart-Images-Containers]]
-* [[Author Docker files|Quickstart-Docker-Files]]
-* [[Work with container registries|Quickstart-Container-Registries]]
-* [[Debug container application|Quickstart-Debugging]]
+* [[ASP.NET Core|ASP-NET-Core]]
+* [[Node.js|Node-JS]]
+* [[Work with container registries|Work-With-Container-Registries]]
 
 ## Tutorials 
 
-* [[.NET Core|Tutorial-DotNet]]
-* [[Node.js|Tutorial-NodeJS]]
-* [[Docker in a dev container|Tutorial-DevContainer]]
-* [[Docker and Windows Subsystem for Linux (WSL)|Tutorial-WSL]]
-* [[Use Docker extension with a remote machine|Tutorial-Remote-SSH]]
+* [[Multi-service application with Docker Compose|Docker-Compose]]
+* [[Docker and Windows Subsystem for Linux (WSL)|Windows-Subsystem-For-Linux]]
 
 ## How to
 
@@ -23,7 +20,8 @@
 * [[Deploy images to Azure App Service|App-Service]]
 * [[Customize extension behavior|Extension-Properties]]
 * [[Customize container build and execution with tasks|Tasks]]
-* [[Add a new container registry provider|Custom-Container-Registry]]
+* [[Add a new container registry provider|Contribute-a-Registry-Provider]]
 * [[Docker extension API|Docker-Extension-API]]
 * [[Connect to a remote Docker daemon over SSH|SSH]]
+* [[Docker in a dev container|Tutorial-DevContainer]]