updated docs
be more verbose on errors