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
19442	Documentation: db transactions clarification	startup.canada@…	nobody	"In section https://docs.djangoproject.com/en/dev/topics/db/transactions/#requirements-for-transaction-handling says ""Django requires that every transaction that is opened is closed before the completion of a request. If you are using autocommit() (the default commit mode) or commit_on_success(), this will be done for you automatically."", giving the impression that given the autocommit we never need to perform commits, but this is not correct for the case of writing raw sql inserts, as explained in https://docs.djangoproject.com/en/dev/topics/db/sql/#executing-custom-sql-directly ""After performing a data changing operation, you should then call transaction.commit_unless_managed() to ensure your changes are committed to the database"". 

Just for clarification I suggest adding in the #requirements-for-transaction-handling a sentence mentioning the need for manually committing for raw sql inserts and/or linking to the executing-custom-sql-directly section."	Cleanup/optimization	closed	Documentation	1.4	Normal	invalid			Accepted	1	0	0	0	0	0