another big round of edits
Merge pull request #56 from UCB-RAC/master

another big round of documentation edits