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
22029	documentation: new best place to put the signal handler registration	Val Neekman	nobody	"The new best place for registering the signal handlers are in the ready() of the AppConfig.

This way, the signals properly emit with the server starts and also via the django-admin shell.

The documentation would benefit from an update indicating the new feature of Django 1.7.

The following section may require the update.
https://docs.djangoproject.com/en/dev/ref/signals/#django.db.models.signals.pre_migrate
https://docs.djangoproject.com/en/dev/ref/signals/#django.db.models.signals.post_migrate


'''This:'''
""Any handlers that listen to this signal need to be written in a particular place: a management module in one of your INSTALLED_APPS. If handlers are registered anywhere else they may not be loaded by migrate.""
'''Could be changed to:'''
""Any handlers that listen to this signal need to be written in a particular place: the AppConfig.ready() within the apps module in one of your INSTALLED_APPS. If handlers are registered anywhere else they may not be loaded by migrate.""
"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		vneekman@…	Accepted	1	0	0	0	0	0