Move validation docs into one place.
Feedback from code review.