Add docs and instructions on how to use the validator tool

[swcurran]

@andrewwhitehead - please give a quick review if you get a chance. No worries if not -- I'll test and merge.