Clarified documentation in some places and fixed sentence fragment