diff --git a/README.md b/README.md
index 6918f51eae5a4ef05d49fe4449bc026c3a89f987..65bc09a5a0e18c94070587f0689c3a9c52b59687 100644
--- a/README.md
+++ b/README.md
@@ -9,11 +9,17 @@ c++ compiler
 cmake
 libudev
 
+obtaining repository
+--------------------
+    $ git clone --recursive git@gitlab.c3sl.ufpr.br:simmc/agent.git
+
+the `--recursive` will download the repository and the submodles 
+
 building and compiling
 ----------------------
 Run
 
-	$ cd build
+	$ mkdir build && cd build
 	$ cmake ..
 	
 to generate a `Makefile`, library objects and misterious CMake files, then
@@ -75,16 +81,16 @@ Clone doxygen project from github
 
 	$ git clone https://github.com/doxygen/doxygen
 
-requirements - flex lib
+requirements - flex lib and bison
 -----------------------
 
-	$ apt-get install flex
+	# apt-get install flex bison
 
 Building and compiling
 ----------------------
 
 	$ cd doxygen
-	$ mkdir build
+	$ mkdir build && cd build
 	$ cmake -G "Unix Makefiles" ..
 	$ make