doc updates

Author: Tim Etchells

CONTRIBUTING.md

@@ -1,17 +1,20 @@
 # Contributing
 
-Anyone can contribute to the Microclimate Tools for VSCode project, and we welcome your contributions! [Visit us on Slack](https://slack-invite-ibm-cloud-tech.mybluemix.net/) if you have any questions.
+Anyone can contribute to the Microclimate Tools for VS Code project, and we welcome your contributions! [Visit us on Slack](https://slack-invite-ibm-cloud-tech.mybluemix.net/) if you have any questions.
 
 ## Raising issues
 
-Please raise any bug reports [here](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/issues). Be sure to search the list to see if your issue has already been raised, and visit our [troubleshooting page](https://microclimate-dev2ops.github.io/mdt-vsc-troubleshooting) too.
+If you have identified a problem or have a feature request, we would love to hear about it.
 
-A good bug report is one that make it easy for everyone to understand what you were trying to do and what went wrong. Provide as much context as possible so we can try to recreate the issue. Please upload your extension logs with your issue report; instructions for this are also available on the [troubleshooting page](https://microclimate-dev2ops.github.io/mdt-vsc-troubleshooting).
+
+Search the [list of issues](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/issues) to see if your issue has already been raised. Also visit our [troubleshooting page](https://microclimate-dev2ops.github.io/mdt-vsc-troubleshooting). If you do not see your issue in either of these places, go ahead and [open a new one](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/issues/new).
+
+Please provide context so that we can understand the problem and try to recreate the issue. Instructions for uploading the logs are available on the [troubleshooting page](https://microclimate-dev2ops.github.io/mdt-vsc-troubleshooting).
 
 ## Developer Certificate of Origin
 
-If you are contributing changes via a pull request, you must sign-off those changes against the [Developer Certificate of Origin](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/blob/master/DCO1.1.txt).
+If you contribute changes with a pull request, sign off those changes against the [Developer Certificate of Origin (DCO)](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/blob/master/DCO1.1.txt).
 
-To indicate you have read and agreed to the DCO, use [`git commit --signoff`](https://git-scm.com/docs/git-commit#git-commit---signoff). It should result in something like the following at the bottom of your commit message:
+To indicate that you have read and agreed to the DCO, use [`git commit --signoff`](https://git-scm.com/docs/git-commit#git-commit---signoff), which adds a statement similar to the following at the end of your commit message:
 
 ```DCO 1.1 Signed-off-by: Random J Developer <[email protected]>```

LICENSE.txt LICENSELICENSE.txt renamed to LICENSE

@@ -1,38 +1,39 @@
-# Microclimate Developer Tools for VSCode
+# Microclimate Developer Tools for VS Code
 
 [![Build Status](https://travis-ci.com/microclimate-dev2ops/microclimate-vscode-tools.svg?token=wpsJvyUkyhtfRa9prmMq&branch=master)](https://travis-ci.com/microclimate-dev2ops/microclimate-vscode-tools)
+[![License](https://img.shields.io/badge/License-EPL%201.0-red.svg)](https://opensource.org/licenses/EPL-1.0)
+[![Marketplace](https://shields-staging.herokuapp.com/vscode-marketplace/v/IBM.microclimate-tools.svg)](https://marketplace.visualstudio.com/VSCode)
 
 - **[Marketplace](https://marketplace.visualstudio.com/VSCode)**
 - **[Documentation](https://microclimate-dev2ops.github.io/mdt-vsc-overview)**
 - **[Slack](https://slack-invite-ibm-cloud-tech.mybluemix.net/)**
-- **[Extension Readme](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/blob/master/dev/README.md)**
+- **[Extension README](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/blob/master/dev/README.md)**
+
+You can use Microclimate Developer Tools for Visual Studio Code to develop your [Microclimate](https://microclimate-dev2ops.github.io) projects from within VS Code. Use the tools to access Microclimate features in the comfort of your IDE.
 
 ## How to install [(Documentation)](https://microclimate-dev2ops.github.io/mdt-vsc-getting-started)
 
-1. Install [VSCode 1.27 or newer](https://code.visualstudio.com/download) and [local Microclimate 18.12 or newer](https://microclimate-dev2ops.github.io/installlocally).
-2. Install Microclimate Developer Tools for VSCode from the [VSCode Marketplace](https://marketplace.visualstudio.com/VSCode), or by searching for "Microclimate" in the [VSCode Extensions view](https://code.visualstudio.com/docs/editor/extension-gallery#_browse-for-extensions).
+1. Install [VS Code version 1.27 or later](https://code.visualstudio.com/download) and [local Microclimate version 18.12 or later](https://microclimate-dev2ops.github.io/installlocally).
+2. Install Microclimate Developer Tools for VS Code from the [VS Code Marketplace](https://marketplace.visualstudio.com/VSCode) or by searching for "Microclimate" in the [VS Code Extensions view](https://code.visualstudio.com/docs/editor/extension-gallery#_browse-for-extensions).
 
-For development builds, see the [releases page](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/releases), and follow [these instructions](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix) to install.
+For development builds, see the [releases page](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/releases). Follow the [Install from a VSIX](https://code.visualstudio.com/docs/editor/extension-gallery#_install-from-a-vsix) instructions to install.
 
 ## How to use [(Documentation)](https://microclimate-dev2ops.github.io/mdt-vsc-tutorial)
-- Open the Microclimate Projects view within the Explorer view group (`Ctrl/Cmd + Shift + E`),
-    - Right-click to create a default local connection.
-    - Right-click a project to see the actions available (see below)
-- Open the Command Palette (`Ctrl/Cmd + Shift + P`) and type "Microclimate" to see the actions available
+- Navigate to the **Explorer** view group and open the **Microclimate** view.
+    - Right-click the background of the Microclimate view to access the **New connection** commands.
+    - Right-click a connection or project to access the other commands.
+- Open the **Command Palette** keys and type "Microclimate" to see the actions available.
 
 ## Features [(Documentation)](https://microclimate-dev2ops.github.io/mdt-vsc-commands-overview)
-- View all projects in Microclimate, including their app and build statuses
-- Debug Microprofile, Spring, and Node.js Microclimate projects
-- View application and build logs in the VSCode *Output* view
-- View project information, similar to the Microclimate *Overview* page
-- Open your applications in the system browser
-- Integrate Microclimate validation errors into the VSCode *Problems* view
-- Open a shell session into a Microclimate application container
-- Open the *App Monitor* page
-- Toggle project auto-build
-- Manually initiate project builds
-- Scope your VSCode workspace to a Microclimate project or to your *microclimate-workspace*
-- Disable, enable, and delete projects
+- View all projects in Microclimate, including application and build statuses.
+- Debug Microprofile, Spring, and Node.js Microclimate projects.
+- View application and build logs in the VS Code **Output** view.
+- View project information similar to the information on the Microclimate **Overview** page.
+- Integrate Microclimate validation errors into the VS Code **Problems** view.
+- Open a shell session into a Microclimate application container.
+- Toggle project auto build and manually initiate project builds.
+- Scope your VS Code workspace to a Microclimate project or to your `microclimate-workspace`.
+- Disable, enable, and delete projects.
 
 ## Contributing
-We welcome [issues](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/issues) and contributions from the public! See [CONTRIBUTING.md](https://github.ibm.com/dev-ex/microclimate-vscode/tree/master/CONTRIBUTING.md).
+We welcome [issues](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/issues) and contributions. For more information, see [CONTRIBUTING.md](https://github.com/microclimate-dev2ops/microclimate-vscode-tools/tree/master/CONTRIBUTING.md).