documentation wording

Fixes #1025