improve exceptions
fix 'raises' docstring format
clean up docs