DOC: cleanup to existing text, filled out more details throughout