adding docs about "fail" handler; removing redundant .call in fail()