Overall documentation fixes for v2.0 release

[bcorrie]

This pull request captures discussion around closing of all the related documentation issues for v2.0.

Driven by and should close:

• Closes #745
• Closes #730

Other related issues:

• Closes #732
• Closes #549
• Closes #702
• Closes #545
• Closes #727

[javh]

From the call:

• Check that these changes are already merged.
• Set Project to Documentation for these issues.
• Close this PR.

[javh]

Tagged everything. Commits look redundant.