Update docs, clarify wording in comments