documentation review fixes
Merging #45 on doc changes (review fixes from Andy)