and fixe some errors in rst syntax
This should ease the browsing fo documentation (less menu and submenus)