updated README

Author: saniales

README.adoc

@@ -10,16 +10,48 @@ It implements all functions provided by web version of Arduino Create.
  . `git clone` this repository into a folder of your choice
  . Add '/path/to/arduino-cli/folder' to your PATH environment variable
  . Reload shell configuration or reboot
- And you're done, now let's see how to use the CLI.
+
+
+== Compiling
+you have two ways:
+
+.> By running the go main file.
+[source, bash]
+----
+$ go run main.go ARGS
+----
+
+.> By compiling then running the go program.
+[source, bash]
+----
+$ go build -o arduino
+$ ./arduino ARGS
+----
+
+If you want autocompletion and manpages you have to compile and execute (second way)
+
+And you're done, now let's see how to use the CLI.
 
 == Usage : An example
 
-A general call is `arduino [COMMAND] [options]`
-To see the full list of commands, call `arduino help [COMMAND]`, arduino [COMMAND] -h` or `arduino [COMMAND] --help`
+A general call is
+[source, bash]
+----
+  $ arduino [COMMAND] [options]
+----
+
+To see the full list of commands, call one of the following:
+[source, bash]
+----
+  $ arduino help [COMMAND]
+  $ arduino [COMMAND] -h
+  $ arduino [COMMAND] --help
+----
 
-output from help command:
+Here is the output from help command `arduino help`:
 [source, bash]
 ----
+$ arduino help
 Arduino Create Command Line Interface (arduino-cli)
 
 Usage:
@@ -42,7 +74,7 @@ Flags:
 Use "arduino [command] --help" for more information about a command.
 ----
 
-== Contribution
+== Contributing
 
 To contribute to this project: