karen edits

update document to reflect karen’s first edits on these docs