Update documentation for new features

Closes #24.
Adapt Matt’s doc updates to Joel’s grammatical taste
Merge Matt’s documentation updates

Closes #25.