diff --git a/README.md b/README.md
index 6f9c078b..d8a82265 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,19 @@
-# microbit target for KindScript
+# micro:bit target for KindScript
 
+This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using [KindScript](https://github.com/Microsoft/kindscript).
 
-## Regular installation
+# Getting started
 
-If you're making changes to kindscript repository itself, proceed to **Local installation** below.
+> If you're making changes to kindscript repository itself, proceed to **Local installation** below.
+
+* Clone this repo and run
+
+```
+npm install
+```
+
+* Install the `KindScript` tool and launch the local server:
 
-Installation:
 ```
 npm install -g kindscript-cli
 kind serve
@@ -15,7 +23,13 @@ To re-build the `built/target.json` file, re-run `kind serve`.
 
 ## Local installation
 
-Make sure `kindscript-microbit` is in a directory next to `kindscript`.
+* Clone and build [KindScript](https://github.com/Microsoft/kindscript) in a `kindscript` folder.
+* Clone this repo  in a `kindscript-microbit` folder next to `kindscript`
+
+```
+npm install
+```
+* To build and deploy new changes
 
 ```
 npm install -g kindscript-cli
@@ -25,4 +39,4 @@ cd ../kindscript-microbit
 npm link ../kindscript
 kind serve
 ```
-
+* open `localhost:3232` to try your editor!
\ No newline at end of file