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 incorrectly	ティン・ルーフ	nobody	"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?"	Uncategorized	new	Documentation	2.0	Normal				Unreviewed	0	0	0	0	1	0