Doc changes

* Add link to baron repository
* Code block for python highlighting
* s/alternativly/alternatively
[fix] Url rst syntax
[enh] More readable doc

* Add syntax highlighting for python examples
* Little typos
[fix] Markdown to rst
[enh] Make command in text more visible
Merge pull request #1 from Astalaseven/master

Little changes in doc