doc clarification and mentioning new clean up practice