add more clarification to docs