Documentation fixes

Broken intersphinx links
Single backticks where double should have been used.
Some grammar and style
Merge pull request #395 from firedrakeproject/doc-fixes

Documentation fixes