some docs updates for clarification