Fixed #25356 -- Removed default_app_config from startapp template.

Also discouraged its use outside the intended use case.

1 files changed, 3 insertions, 1 deletions

diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 5ca931ad89..eb3cc6fd85 100644
--- a/docs/ref/applications.txt
+++ b/docs/ref/applications.txt
@@ -81,7 +81,9 @@ subclass by default as follows::
 That will cause ``RockNRollConfig`` to be used when :setting:`INSTALLED_APPS`
 just contains ``'rock_n_roll'``. This allows you to make use of
 :class:`~django.apps.AppConfig` features without requiring your users to
-update their :setting:`INSTALLED_APPS` setting.
+update their :setting:`INSTALLED_APPS` setting. Besides this use case, it's
+best to avoid using ``default_app_config`` and instead specify the app config
+class in :setting:`INSTALLED_APPS` as described next.
 
 Of course, you can also tell your users to put
 ``'rock_n_roll.apps.RockNRollConfig'`` in their :setting:`INSTALLED_APPS`