More docs (and docstrings) fixes: Typos, punctuation and better cross-linking.
Merge pull request #23 from ramiro/doc-fixes

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