Typos and doc usability tweaks

Thanks to Lloyd Prentice for the feedback.