INTPYTHON-789 Document how to configure contrib apps with models

Author: timgraham

docs/howto/contrib-apps.rst

@@ -5,6 +5,20 @@ Configuring Django's contrib apps
 Generally, Django's contribs app work out of the box, but here are some
 required adjustments.
 
+Apps with models
+================
+
+Each contrib app that has models that use :class:`~django.db.models.AutoField`
+(:mod:`~django.contrib.admin`, :mod:`~django.contrib.auth`,
+:mod:`~django.contrib.contenttypes`, :mod:`~django.contrib.flatpages`,
+:mod:`~django.contrib.redirects`, and :mod:`~django.contrib.sites`) must:
+
+#. Be configured with an ``AppConfig`` that specifies
+   ``default_auto_field = "django_mongodb_backend.fields.ObjectIdAutoField"``.
+   See :ref:`specifying the-default-pk-field`.
+#. Have migrations that use :class:`.ObjectIdAutoField`. See
+   :ref:`configuring-migrations`.
+
 ``contrib.sites``
 =================
 

docs/intro/configure.rst

@@ -53,6 +53,8 @@ Each app reference in the :setting:`INSTALLED_APPS` setting must point to the
 corresponding ``AppConfig``. For example, instead of ``'django.contrib.admin'``,
 the template uses ``'<project_name>.apps.MongoAdminConfig'``.
 
+.. _configuring-migrations:
+
 Configuring migrations
 ======================