DOC : edits addressing some of Eric's comments