(doc) clarify docs