Fix documentation tests and add link in README.rst

This fixes the documentation tests, where appropriate, and adds a link to the online documentation in README.rst.