Clarify configuration documentation for issue #921.
Merge pull request #922 from cjerdonek/issue-921-configuration-docs

Address issue #921: clarify configuration documentation