Update readme 📚 with current experience (#80)

.vscodeignore

@@ -13,6 +13,7 @@ docs/**
 gulp*
 node_modules/**
 out/**
+resources/readme/**
 src/**
 stats.json
 test-results.xml

README.md

@@ -6,19 +6,44 @@ Create and manage Azure Virtual Machines directly from VS Code.
 
 > Sign up today for your free Azure account and receive 12 months of free popular services, $200 free credit and 25+ always free services 👉 [Start Free](https://azure.microsoft.com/free/open-source).
 
+## Installation
+
+1. Download and install the [Azure Virtual Machines extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azurevirtualmachines) for Visual Studio Code
+2. Once complete, you'll see an Azure icon in the Activity Bar
+    > If your activity bar is hidden, you won't be able to access the extension. Show the Activity Bar by clicking View > Appearance > Show Activity Bar
+3. Sign in to your Azure Account by clicking Sign in to Azure…
+    >  If you don't already have an Azure Account, click "Create a Free Azure Account" or you can [try Azure for free](https://code.visualstudio.com/tryappservice/?utm_source=appservice-extension)
+
 ## Features
 
 * View, create, delete, start, stop, and restart Azure Virtual Machines
 * Add SSH key to existing Azure Virtual Machines
 
-### Create New Virtual Machine
+## Create a New Virtual Machine
 
-![CreateVirtualMachine](resources/CreateVirtualMachine.gif)
+Once you are signed in, you can create your Azure Virutal machine by clicking the "+" button or by right-clicking your subscription.
 
-### Add SSH key to existing Virtual Machine
+![CreateVirtualMachine](resources/readme/createAzureVM.png)
 
-![AddSSHKey](resources/AddSSHKey.gif)
+1. Choose **Create Virtual Machine**
+2. Type a name for your VM.  Alphanumeric characters are all valid.
+3. Type a passphrase or leave it empty for no passphrase.
+    >For security reasons, it's _highly_ recommended that you use a passphrase for your SSH key.  It is what will be used to connect to your VM via SSH.
 
+The VM will be **Standard D2s V3** (2 CPU Cores & 8 GB of ram) with the image **Ubuntu 18.04-LTS**. An SSH key will be created and your SSH Config file (`~/.ssh/config`) will be updated so you can immediately connect via SSH (`$ ssh vm-name`) or using the [Remote-SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) extension.
+
+
+## Add SSH key to existing Virtual Machine
+
+If you have an existing VM that you would like to add your own SSH key too, you can do that by right-clicking the VM tree item, clicking **Add SSH Key...**, and selecting an existing SSH key. You can generate an SSH key using [SSH Keygen](https://www.ssh.com/ssh/keygen#creating-an-ssh-key-pair-for-user-authentication) if you don't have any keys on your system.
+
+Your SSH Config (`~/.ssh/config`) file will be updated so you can connect via SSH using `$ ssh vm-name`.
+
+![AddSSHKey](resources/readme/AddSSHKey.png)
+
+## Remote into Azure VM via SSH
+
+- Use [Visual Studio Code Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) to seamlessly connect to your Azure VM from VS Code.
 
 ## Contributing