Fixed #25356 -- Removed default_app_config from startapp template.

Also discouraged its use outside the intended use case.

2 files changed, 4 insertions, 2 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`
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index ed5ac98947..4a9c78a3db 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1523,7 +1523,7 @@ Default: ``[]`` (Empty list)
 A list of strings designating all applications that are enabled in this
 Django installation. Each string should be a dotted Python path to:
 
-* an application configuration class, or
+* an application configuration class (preferred), or
 * a package containing an application.
 
 :doc:`Learn more about application configurations </ref/applications>`.