[fixup] clarify docs