diff --git a/README.md b/README.md
index 384dadfb..39c6567e 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,9 @@
 
 ---
 
-instructions: see Makefile
+instructions:  
+(optional) `make clean && make`: remove build artifacts and recompile the project
+`make run`: launch the demo app using the translation layer
 
 ##### FAQ: