diff --git a/README.md b/README.md
index cf105a6..d6a96ea 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
-# learn_mqtt_go
+# Learn MQTT with Go
 
-Learning MQTT with Golang
\ No newline at end of file
+Learning MQTT with Golang by doing. This repo is a simple example of using a Golang application as a client (pub & sub) of an MQTT broker.
+
+
+## Development
+
+Start the local development environment with:
+
+```
+make start-dev
+```
+
+Stop with
+
+```
+make stop-dev
+```
+
+
+## Usage
+
+*Instructions TBD*
\ No newline at end of file