Added documentation for new validation
NEW: Added another ValidationException constructor
NEW: Added extra ValidationResult methods

These methods are needed to make the examples shown in the docs work.  There were are few edge-cases
that weren't particularly concise.