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
21836	clarify behavior of autocommit mode in presence of transaction	Chris Jerdonek	Aymeric Augustin	"As someone relatively new to Django, in reading the [https://docs.djangoproject.com/en/dev/topics/db/transactions/#module-django.db.transaction ""Database transactions""] section of the Django docs, I thought a couple things could be clarified or improved.

Namely, it would be helpful to clarify that both (1) the default ""autocommit"" behavior of immediately committing doesn't occur if a transaction has already been started, and (2) Django's main TestCase class implicitly starts a transaction (thus ""suspending"" the default autocommit behavior).  Not mentioning the latter in the main transaction docs contributed to my running into documentation issue #21540, so I think resolving this issue will help address issue #21540.

I've already written up a proposed patch with suggested wording for the above.  I will post it to this issue shortly.  Thanks.
"	Cleanup/optimization	closed	Documentation	1.6	Normal	fixed	autocommit,transactions,database	chris.jerdonek@…	Ready for checkin	1	0	0	0	0	0