document Batman.Validator

Adds docs for `Batman.Validator` (and how to subclass it). 

Wording for `@triggers` and `@options` was tough! Any suggestions or feedback?