diff --git a/docs/code.md b/docs/code.md
index 00f5bc98..550a9eae 100644
--- a/docs/code.md
+++ b/docs/code.md
@@ -1,10 +1,14 @@
 # Visual Studio Code
 
-Visual Studio Code is a Free Open Source code editor. Edit your programs with  
+Visual Studio Code is a Free Open Source code editor that you can use to edit your programs.
+
+Working from Visual Studio code allows you to benefit from all the features
+of a professional IDE while working with PXT: working with files, 
+git integration (or source control of your choice), hundreds of extensions.
 
 ![](https://code.visualstudio.com/home/home-screenshot-win-lg.png)
 
-## Tools setup
+## Setup
 
 Follow these instructions to setup your machine and edit your programs in Visual Studio Code.
 
@@ -27,20 +31,21 @@ That's it! You are ready to create new projects in code or open existing project
 
 ## Creating a new project
 
-Open a shell to your projects folder.
+Open a shell to your ``microbit`` folder.
 
 ```
 # create a new subfolder for your project
 mkdir myproject
+cd myproject
 # start the project set
 pxt init
 # open code
-code. 
+code . 
 ```
 
 ## Opening an existing project 
 
-You can extract a project from the embedded URL. Open a shell to your projects folder
+You can extract a project from the embedded URL or .hex file. Open a shell to your projects folder
 
 ```
 # extract the project from the URL