Fixes #2702. Also cleans up formatting and long lines in volumes doc.
fixed typos, and small improvements to the wording