diff --git a/examples/ciao/README.md b/examples/ciao/README.md
index 67394d9..bba4f0f 100644
--- a/examples/ciao/README.md
+++ b/examples/ciao/README.md
@@ -71,8 +71,6 @@ Optionally edit [group_vars/all](group_vars/all) file to change default password
 
     ansible-playbook -i hosts ciao.yml
 
-Note: In order to deploy ciao from the latest development branch set `ciao_dev = True` in [group_vars/all](group_vars/all) file or pass the command line argument `--extra-vars "ciao_dev=true"`
-
 ---
 
 ## NOTES:
@@ -90,3 +88,6 @@ the line "dns=dnsmasq" from /etc/NetworkManager/NetworkManager.conf
 
 Make sure the hosts running docker (controller and compute nodes) have a correctly
 configured dns server that can resolve the cluster nodes names.
+
+## Installing ciao from sources
+If you are interested in deploying ciao from the master branch, read [this](doc/development.md)
diff --git a/examples/ciao/doc/development.md b/examples/ciao/doc/development.md
new file mode 100644
index 0000000..48e53da
--- /dev/null
+++ b/examples/ciao/doc/development.md
@@ -0,0 +1,8 @@
+# Development Mode
+This playbooks installs ciao from the latest ciao packaged for your distro.
+
+If you want to try the latest features, there is a way to use this playbook to
+deploy ciao from github.com/01org/ciao master branch source code.
+
+Set `ciao_dev = True` in [group_vars/all](../group_vars/all) file or pass the
+command line argument `--extra-vars "ciao_dev=true"`