Update docs.

* fix typos
* break long lines
* use the relative URLs
* use code syntax in more places
Losslessly compress images.

Before: 215 KB (220.636 bytes)
After:  213 KB (218.620 bytes)
Minor changes to the README
Merge branch 'XhmikosR-develop'