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
30005	Example in documentation of transaction.atomic uses both decorator and context manager	Peter Hull	Peter Hull	"In the documentation of transaction.atomic (https://docs.djangoproject.com/en/2.1/topics/db/transactions/#controlling-transactions-explicitly), the example below the line ""Wrapping atomic in a try/except block allows for natural handling of integrity errors"" uses both the decorator and the context manager versions of atomic().  This wouldn't necessarily be a problem except that using the decorator here causes the example to do exactly what the warning a couple paragraphs later says not to do: ""Avoid catching exceptions inside atomic!""  I suggest that removing the use of the decorator in the example would be the most prudent edit?"	Bug	closed	Documentation	2.1	Normal	invalid			Accepted	1	0	0	0	1	0