doc: guide edits in-line with suggestions from geojeff