id summary reporter owner description type status component version severity resolution keywords cc stage has_patch needs_docs needs_tests needs_better_patch easy ui_ux 29430 django.core.mail.send_mail()'s fail_silently kwarg is documented confusingly ティン・ルーフ Sub "From https://docs.djangoproject.com/en/2.0/topics/email/#send-mail: “If it’s False, send_mail will raise an smtplib.SMTPException.” This is often untrue, and certainly misleading. Certainly, if it's False, send_mail is ''capable'' of raising SMTPException, but it's not guaranteed. I was going to open a pull request and change it to “If it's True, send_mail can raise smtplib.SMTPException”, but I'm not confident that other exceptions cannot be raised, or that send_mail will never raise SMTPException if fail_silently is True. The main thing I would like would be for the intent of fail_silently to be expressed; what kind of errors is it trying to suppress, for example? What kind of emails could a Django site be sending that are unimportant enough that failing silently is a good idea?" Cleanup/optimization closed Documentation 2.0 Normal fixed Accepted 0 0 0 0 1 0