#1144 validator classes documentation split

This is a rebased version of #1144

@froschdesign could you give me your yep/nope?