Improve various documentation and validation

Take a pass at adding missing docstrings and improve error messaging for
malformed mixins