review feedback.

Tweak a bunch of documentation, etc.
Merge branch 'api-versioning-5-state-call-takes-version' into api-versioning-6-update-clients