home.markdown

-# What is Bosh ?
-
+## What is Bosh ?
 Bosh means Bokeh Shell. It is a command line tool for managing bokeh web sites.
 
-# Availables commands
+## How it works ?
+Use bosh this way:  
+```bash
+bosh command --option1=value2 parameter1 --option2=value2
+```
+command (required): Is the comand name to launch  
+option (optional): A key / value pair providing data for the command  
+parameter (optional): Provides more infomation about how to run the command  
+
+On servers that host several instances of Bokeh sites, Bosh commands will act on the instance according to where, on the directory tree, you have launched the command.  
+
+```bash
+# Act on bokeh1 site
+webmaster@hosting-server:/var/www/bokeh1$ bosh select-db my-db
+
+# Act on bokeh2 site
+webmaster@hosting-server:/var/www/bokeh2$ bosh select-db my-db
+
+# Also act on bokeh2 site
+webmaster@hosting-server:/var/www/bokeh2/public/opac$ bosh select-db my-db
+```
+
+
+## Availables commands
 
 __select-db:__  
 ```bash