Adjust documentation.rst

Fixed some typos, added note about Sphinx warnings.