Correct and copyedit limitations page

Author: timgraham

source/limitations-upcoming.txt

@@ -34,36 +34,32 @@ Feature Limitations
 In this section, you can learn about the following
 types of unsupported {+framework+} and MongoDB features:
 
-- :ref:`django-limitations-database`
+- :ref:`django-limitations-transactions`
 - :ref:`django-limitations-models`
 - :ref:`django-limitations-query`
 - :ref:`django-limitations-management`
 - :ref:`django-limitations-migration`
-- :ref:`django-limitations-async`
-- :ref:`django-limitations-data`
 - :ref:`django-limitations-performance`
 
-.. _django-limitations-database:
+.. _django-limitations-transactions:
 
-Unsupported Database Variables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Transaction management
+~~~~~~~~~~~~~~~~~~~~~~
 
-The following database variables are not supported by {+django-odm+}:
+Query execution uses Django and MongoDB's default behavior of autocommit mode.
+Each query is immediately committed to the database.
 
-- ``ATOMIC_REQUESTS``
-- ``AUTOCOMMIT``
-- ``CONN_HEALTH_CHECKS``
-- ``TIME_ZONE``
+Django's transaction management APIs are not supported.
 
 .. _django-limitations-models:
 
 Model Limitations
 ~~~~~~~~~~~~~~~~~
 
-The following limitations apply to models in {+django-odm+}:
+Django doesn't support MongoDB's `polymorphic pattern`_ where slightly
+different models share the same collection.
 
-- {+django-odm+} enforces a one-to-one mapping between a Django model and a
-  MongoDB collection. Because of this, multiple models cannot share the same collection.
+.._ polymorphic pattern: https://www.mongodb.com/developer/products/mongodb/polymorphic-pattern/
 
 Indexes
 ```````
@@ -121,16 +117,14 @@ Fields
     ``$lookup`` operations, see the :atlas:`Reduce $lookup Operations
     </schema-suggestions/reduce-lookup-operations/>` guide in the Atlas
     documentation.
-  - Performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#django.db.models.CASCADE>`__ 
+  - Performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#django.db.models.CASCADE>`__
     on a ``ForeignKey`` field is not as performant as using an
     ``EmbeddedModelField``.
 
 The following field types are unavailable in {+django-odm+}:
 
 - ``GeneratedField``
-- ``AutoField``
-- ``BigAutoField``
-- ``SmallAutoField``
+- ``AutoField`` (including ``BigAutoField`` and ``SmallAutoField``)
 
 .. _django-limitations-query:
 
@@ -159,12 +153,9 @@ Geospatial Queries
 Aggregation Operators
 `````````````````````
 
-{+django-odm+} does not contain any custom Django field lookups for the MongoDB
-aggregation framework. Instead, use the ``raw_aggregate()`` method. For more
-information on the ``raw_aggregate()`` method, see
-the :ref:`django-raw-queries` guide.
-
-.. TODO: Link to aggregation
+{+django-odm+} does not include any custom Django field lookups for the MongoDB
+aggregation framework. Instead, use the ``raw_aggregate()`` method. See the
+:ref:`django-raw-queries` guide.
 
 Database Functions
 ``````````````````
@@ -188,16 +179,13 @@ properly because MongoDB converts the result back to UTC.
 
 .. _django-limitations-management:
 
-Django Management Command Limitations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Unsupported Management Commands
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-{+django-odm+} does not support the following Django management commands:
+The following ``django-admin`` management commands are unsupported:
 
 - ``createcachetable``
 - ``inspectdb``
-- ``optimizemigration``
-- ``sqlflush``
-- ``sqlsequencereset``
 
 .. _django-limitations-migration:
 
@@ -213,22 +201,6 @@ Migration Limitations
 - `DDL Transactions <{+django-docs+}/topics/migrations/#transactions>`__.
 - ``migrate --fake-initial`` command.
 
-.. _django-limitations-async:
-
-Asynchronous Limitations
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-{+django-odm+} has not been tested for support of the asynchronous functionality of
-the Django API.
-
-.. _django-limitations-data:
-
-Data Types
-~~~~~~~~~~
-
-{+django-odm+} does not have a custom ``Field`` class for the ``BSONRegExp``
-data type. Instead, use the ``CharField`` class.
-
 .. _django-limitations-performance:
 
 Performance
@@ -245,23 +217,20 @@ General Availability Release Features
 -------------------------------------
 
 In this section, you can learn about the following
-types of {+framework+} and MongoDB features that 
+types of {+framework+} and MongoDB features that
 GA and post-GA {+django-odm+} releases will likely introduce:
 
 - :ref:`django-upcoming-mongodb`
 - :ref:`django-upcoming-models`
 - :ref:`django-upcoming-management`
 - :ref:`django-upcoming-third-party`
-- :ref:`django-upcoming-variables`
-- :ref:`django-upcoming-async`
 
 .. _django-upcoming-mongodb:
 
 MongoDB Features
 ~~~~~~~~~~~~~~~~
 
-We plan to support the following MongoDB features in
-the GA release:
+We plan to support the following MongoDB features in the GA release:
 
 - Programmatic management of Vector Search, Atlas Search,
   and geospatial indexes by using the Django API
@@ -271,8 +240,7 @@ the GA release:
 - Database transactions
 - Storage of cached data in the database
 
-We plan to support the following MongoDB features in
-future post-GA releases:
+We plan to support the following MongoDB features in future post-GA releases:
 
 - GridFS for large file storage
 - Change streams for data monitoring
@@ -301,8 +269,7 @@ future post-GA releases:
 Model Features
 ~~~~~~~~~~~~~~
 
-We plan to support the following model features in
-the GA release:
+We plan to support the following model features in the GA release:
 
 - Arrays of embedded documents
 - Polymorphic embedded documents and arrays
@@ -311,49 +278,27 @@ the GA release:
 - Multiple models within a collection
 - Improved form representation in embedded models
 
-In future post-GA releases, we plan to support a custom ``Field``
-class for the ``BSONRegExp`` data type.
+In a future post-GA release, we plan to add a custom model field for the
+``BSONRegExp`` data type.
 
 .. _django-upcoming-management:
 
-Django Management Command Features
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Management Command Features
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-We plan to support the following Django commands in
-the GA release:
-
-- ``dumpdata``
-- ``loaddata``
+Serialization support for ``EmbeddedModelField`` (i.e. Django's `dumpdata`` and
+``loaddata`` management commands) will be added by the GA release.
 
 .. _django-upcoming-third-party:
 
-Third Party Features
-~~~~~~~~~~~~~~~~~~~~
+Third-Party Libraries
+~~~~~~~~~~~~~~~~~~~~~
 
-We plan to support the following third-party features in
-the GA release:
+We plan to test compatibility with the following third-party libraries by the
+GA release:
 
 - `Django-filter <https://django-filter.readthedocs.io/en/stable/>`__
 - `Django Rest Framework <https://www.django-rest-framework.org/>`__
 - `Django-allauth <https://docs.allauth.org/en/latest/>`__
 - `Wagtail <https://wagtail.org/>`__
 - `Django Debug Toolbar <https://django-debug-toolbar.readthedocs.io/en/latest/>`__
-
-.. _django-upcoming-variables:
-
-Database Variable Support
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-We plan to support the following Django variables for configuring
-your database connection in future post-GA releases:
-
-- ``CONN_HEALTH_CHECKS``
-- ``TIME_ZONE``
-
-.. _django-upcoming-async:
-
-Asynchronous Support
-~~~~~~~~~~~~~~~~~~~~
-
-We plan to offer asynchronous support for {+django-odm+} in
-future post-GA releases.