clarifies docs