better error reporting and messages
some formatting
updated the docs