add requireFailure and doc update