Clarify/correct documentation (close #486)