refactor
clarify docs