improve docs (purposely vague)