Move the documentation for validate into the validate docstring

This allows for a better experience when using the Python
interactive interpreter.