I've merged and pushed the pull request.

Do you (or John) plan to make any clarifications to the document as well?