clarify docs note