Documentation fixes

Broken intersphinx links
Single backticks where double should have been used.
Some grammar and style