Minor documentation fixes

Whitespaces, ReST formatting, syntantic errors and a small addition to
README.rst