Documentation patches

A grammar fix and some fleshing-out of the validations section.