add launch/requirements/install docs

Author: ShMcK

README.md

@@ -1,18 +1,34 @@
-# coderoad-vscode README
+# CodeRoad VSCode
 
-## Features
+CodeRoad is a VSCode extension that allows you to play interactive coding tutorials in your editor.
 
-CodeRoad allows you to play interactive coding tutorials in your editor.
+## Getting Started
 
-## Requirements
+### Launch
 
-Requires:
+To start the extension, inside VSCode:
+
+- Open the VSCode command palette.
+  - select “View” > “Command Palette” from the top panel
+  - alternatively, press `cmd/ctrl + shift + P`
+- Search for and run `CodeRoad:Start`
+- A web view should appear on the right side of your editor asking you to click "Start"
+
+### Requirements
 
 - VSCode 1.40+
+  [Download Visual Studio Code - Mac, Linux, Windows](https://code.visualstudio.com/download)
+- VSCode command line tools.
+  For Mac, installation requires an additioanl step. See [Running Visual Studio Code on macOS](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line).
 - Git
 - Node 10+
 
-## Run
+### Installation
+
+> Currently CodeRoad is not yet available in the VSCode marketplace (coming soon!).
+
+To install the extension manually:
 
-1. Open the command prompt: `cmd/ctrl + shift + p`
-2. Search for and run `coderoad:start`
+- run `vsce package` to build the package.
+  Learn more about [VSCE](https://code.visualstudio.com/api/working-with-extensions/publishing-extension)
+- run `code —install-extension coderoad-0.1.0.vsix`.