added comments, identifiers, & text
update README & typos