Updated docs with clarifications.