diff options
| author | Aymeric Augustin <aymeric.augustin@m4x.org> | 2015-09-21 22:42:35 +0200 |
|---|---|---|
| committer | Aymeric Augustin <aymeric.augustin@m4x.org> | 2015-09-22 08:31:50 +0200 |
| commit | 94a36cfd8c66a6be9a1e001b29e4c55071f4e0de (patch) | |
| tree | b77cea33ca68b9b1d5460e401e0d4e79d917c477 /docs/ref/applications.txt | |
| parent | f2975c021d247bf8c6a5fc23988639c636da86f5 (diff) | |
Recommended against default_app_config.
Most likely this is a losing fight -- people seem to love this small
convention -- but at least the reasons for avoiding it will be
documented.
Refs #25356.
Diffstat (limited to 'docs/ref/applications.txt')
| -rw-r--r-- | docs/ref/applications.txt | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt index d634e7351b..498e10c954 100644 --- a/docs/ref/applications.txt +++ b/docs/ref/applications.txt @@ -57,6 +57,14 @@ subclass for that application. If there is no ``default_app_config``, Django uses the base :class:`~django.apps.AppConfig` class. +``default_app_config`` allows applications that predate Django 1.7 such as +``django.contrib.admin`` to opt-in to :class:`~django.apps.AppConfig` features +without requiring users to update their :setting:`INSTALLED_APPS`. + +New applications should avoid ``default_app_config``. Instead they should +require the dotted path to the appropriate :class:`~django.apps.AppConfig` +subclass to be configured explicitly in :setting:`INSTALLED_APPS`. + For application authors ----------------------- |