More docs (and docstrings) fixes: Typos, punctuation and better cross-li...

...nking.