Removed README.rst from docs as index.rst was referenced to
README.rst in directory above, causing me confusion.

A few bits a bobs altered to how.rst.
Added RST links to the README because it makes the docs nicer.