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
8236	Signals Documentation	Greg Taylor	Jacob	"Signals have been un-documented for as long as I can remember. To introduce a backwards-incompatible change minus any documentation at all is a major ""bug"" in that those of us unfamiliar with Django internals are now unable to follow trunk until some kind of documentation is released. While it's not difficult to see how to define custom signals from the BackwardsIncompatible wiki page, there's no mention of how to handle built-in pre_save and other similar signals on a per-model basis. Plus, relying on a very brief scribble on an obscure wiki page is sure to cause lots of unecessary changes.

While the signals rewrite is still fresh on the minds of the developers, please take 15 minutes to document this so we've got something sturdy to go from. Previously a few blogs had produced some very high quality documentation for signals, but we're pretty much ""stranded"" right now."		closed	Core (Other)	dev		fixed	signals		Accepted	0	0	0	0	0	0