document error and resolution