[enh] More readable doc

* Add syntax highlighting for python examples
* Little typos