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
22582	Document the use of mutable objects in request.session	PKL	nobody	"Ive seen several colleagues being bitten when trying to add values to lists/dicts that they stored in sessions.

It should be very explicit, yelled, in the session docs, that mutable values must be handled with care, and that only top-level assignements are detected by the session (and thus pushed to the session stored on save). All other modifications have good chances to be lost after the request is over.

That behaviour of the django session is very similar to all object stores (ZODB, shove, bdb...), but people are rarely aware of that ""mutation detection"" issue, so this trap had better be displayed everywhere.  B-)

"	Bug	closed	Documentation	1.6	Normal	worksforme			Unreviewed	0	0	0	0	1	0