more doc on error handling