Improve doc

fix #669
A lot of fixes in documentation
Add references to ProGit v2 book
Merge pull request #670 from pmiossec/fix_doc

Improve doc