clarify documentation

Clean up some of the documentation text for readability.