Many tiny changes, mostly to documentation, from my peer review.
Two changes I missed when making minor tweaks to the surface API.