Documentation update

Hello,

This is just a little pull request to improve a little bit the documentation before reorganize the reference guide for Propel2.

* [x] Use fenced code blocks
* [x] Fix typos and broken links into the reference guides
* [x] Update informative files

Have a nice day.