text: bunch of stylistic improvements. One added comment.

LGTM=r
R=r
CC=golang-codereviews
https://golang.org/cl/179710043
6 files changed