Updated documentation

Improved detail and clarified wording in comments.