From bbe4b918d6c48eb3d08d9c57d7e208e240c45ba3 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:20:35 -0500 Subject: [PATCH 01/15] DOCSP-46984: Upcoming features --- source/limitations.txt | 185 +++++++++++++++++++++++++++++++++++++---- 1 file changed, 168 insertions(+), 17 deletions(-) diff --git a/source/limitations.txt b/source/limitations.txt index e76b4eb..8d0bcd6 100644 --- a/source/limitations.txt +++ b/source/limitations.txt @@ -1,8 +1,8 @@ .. _django-limitations: -============ -Limitations -============ +================================= +Limitations and Upcoming Features +================================= .. contents:: On this page :local: @@ -27,8 +27,28 @@ releases based on user demand. You can request support for a feature by leaving a suggestion on the `Drivers Feedback Forum `__. +You can also find a list of features that {+django-odm+} +will likely support in upcoming releases. + +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-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: + Unsupported Database Variables ------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following database variables are not supported by {+django-odm+}: @@ -37,8 +57,10 @@ The following database variables are not supported by {+django-odm+}: - ``CONN_HEALTH_CHECKS`` - ``TIME_ZONE`` +.. _django-limitations-models: + Model Limitations ------------------ +~~~~~~~~~~~~~~~~~ The following limitations apply to models in {+django-odm+}: @@ -46,7 +68,7 @@ The following limitations apply to models in {+django-odm+}: MongoDB collection. Because of this, multiple models cannot share the same collection. Indexes -~~~~~~~ +``````` {+django-odm+} does not support the following index functionalities: @@ -59,8 +81,10 @@ To learn how to run unsupported database operations by operating directly on your ``MongoClient`` instance, see :ref:`django-client-operations` in the Perform Raw Database Queries guide. +.. _django-limitations-models-fields: + Fields -~~~~~~ +`````` {+django-odm+} has the following limitations on the specified field types: @@ -115,8 +139,10 @@ The following field types are unavailable in {+django-odm+}: - ``BigAutoField`` - ``SmallAutoField`` +.. _django-limitations-query: + Querying Limitations --------------------- +~~~~~~~~~~~~~~~~~~~~ {+django-odm+} does not support the following ``QuerySet`` API methods: @@ -130,14 +156,14 @@ Querying Limitations that span multiple collections. Geospatial Queries -~~~~~~~~~~~~~~~~~~ +`````````````````` - {+django-odm+} does not support ``GeoDjango``. - {+django-odm+} does not have any Django lookup operators for MongoDB-specific 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 @@ -147,7 +173,7 @@ the :ref:`django-raw-queries` guide. .. TODO: Link to aggregation Database Functions -~~~~~~~~~~~~~~~~~~ +`````````````````` {+django-odm+} does not support the following database functions: @@ -166,8 +192,10 @@ Database Functions The ``tzinfo`` parameter of the ``Trunc`` database functions doesn't work properly because MongoDB converts the result back to UTC. +.. _django-limitations-management: + Django Management Command Limitations -------------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ {+django-odm+} does not support the following Django management commands: @@ -177,8 +205,10 @@ Django Management Command Limitations - ``sqlflush`` - ``sqlsequencereset`` +.. _django-limitations-migration: + Migration Limitations ---------------------- +~~~~~~~~~~~~~~~~~~~~~ - {+django-odm+} does not support enforced schema validation. To learn how to enforce schema validation in your application, see the :manual:`Specify JSON @@ -188,20 +218,26 @@ Migration Limitations <{+django-docs+}/topics/migrations/#transactions>`__. - {+django-odm+} does not support the ``migrate --fake-initial`` command. -Asynchronous Support --------------------- +.. _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 ------------ +~~~~~~~~~~~ The engineering team is prioritizing feature development for the Public Preview release of {+django-odm+}. Because of this, you might notice performance @@ -209,3 +245,118 @@ limitations with certain workloads. If you encounter any performance issues, please report them as shown in the :ref:`Issues & Help ` guide. You can also share your feedback on the `Drivers Feedback Forum `__. + +Upcoming Features +----------------- + +In this section, you can learn about the following +types of {+framework+} and MongoDB features that +General Availability (GA) and post-GA {+django-odm+} releases +will likely introduce: + +- :ref:`django-upcoming-models` +- :ref:`django-upcoming-database` +- :ref:`django-upcoming-third-party` +- :ref:`django-upcoming-management` +- :ref:`django-upcoming-variables` +- :ref:`django-upcoming-async` + +.. _django-upcoming-models: + +Model Features +~~~~~~~~~~~~~~ + +We plan to support the following model features in +upcoming releases: + +- Creating arrays of embedded documents +- Creating polymorphic embedded documents and arrays +- Applying changes to the schema of embedded models to + ``EmbeddedModelField`` values +- Creating multiple models within a collection +- Using forms in embedded models +- Resolve the ``JSONField`` limitations listed in the + :ref:`Field limitations ` section of + this guide +- Using a custom ``Field`` class for the ``BSONRegExp`` data type + +.. _django-upcoming-database: + +Database Features +~~~~~~~~~~~~~~~~~ + +We plan to support the following database features in +upcoming releases: + +- Creating Vector Search, Atlas Search, and geospatial indexes +- Performing Vector Search, Atlas Search, and geospatial queries +- Encrypting data by using Queryable Encryption and Client-side Field Level Encryption +- Running database transactions +- Using specialized aggregation operators +- Specifying schema validation +- Using GridFS to store large files +- Opening change streams to monitor your data + +.. tip:: + + To learn more about the MongoDB features mentioned in this section, see + the following resources: + + - :atlas:`Atlas Vector Search ` in the Atlas documentation + - :atlas:`Atlas Search ` in the Atlas documentation + - :manual:`Geospatial Queries ` in the {+mdb-server+} + manual + - :manual:`In-Use Encryption ` in the {+mdb-server+} + manual + - :manual:`Transactions ` in the {+mdb-server+} + manual + - :manual:`GridFS ` in the {+mdb-server+} + manual + - :manual:`Change Streams ` in the {+mdb-server+} + manual + +.. _django-upcoming-third-party: + +Third Party Features +~~~~~~~~~~~~~~~~~~~~ + +We plan to support the following third-party features in +upcoming releases: + +- `Django-filter `__ +- `Django Rest Framework `__ +- `Django-allauth `__ +- `Wagtail `__ +- `Django Debug Toolbar `__ + +.. _django-upcoming-management: + +Django Management Command Features +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +We plan to support the following Django commands in +upcoming releases: + +- ``dumpdata`` +- ``loaddata`` +- ``inspectdb`` +- ``optimizemigration`` + +.. _django-upcoming-variables: + +Database Variable Support +~~~~~~~~~~~~~~~~~~~~~~~~~ + +We plan to support the following Django variables for configuring +your database connection in upcoming releases: + +- ``CONN_HEALTH_CHECKS`` +- ``TIME_ZONE`` + +.. _django-upcoming-async: + +Asynchronous Support +~~~~~~~~~~~~~~~~~~~~ + +We plan to offer asynchronous support for {+django-odm+} in future +releases. \ No newline at end of file From 93ad7e89de32862ef89bc438affb3adcdea5c83c Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:22:32 -0500 Subject: [PATCH 02/15] landing page --- source/index.txt | 7 ++++--- source/{limitations.txt => limitations-upcoming.txt} | 0 2 files changed, 4 insertions(+), 3 deletions(-) rename source/{limitations.txt => limitations-upcoming.txt} (100%) diff --git a/source/index.txt b/source/index.txt index 7c8adad..4c7efbd 100644 --- a/source/index.txt +++ b/source/index.txt @@ -15,7 +15,7 @@ Django MongoDB Backend Connection Configuration Model Your Data Interact with Data - Limitations + Limitations and Upcoming Features Issues & Help Compatibility API Documentation <{+api+}> @@ -56,10 +56,11 @@ Interact with Data Learn how to use {+django-odm+} to perform operations on MongoDB data in the :ref:`django-interact-data` section. -Limitations ------------ +Limitations and Upcoming Features +--------------------------------- Learn about the features that {+django-odm+} does not support +and features that we plan to support in upcoming releases in the :ref:`django-limitations` section. Compatibility diff --git a/source/limitations.txt b/source/limitations-upcoming.txt similarity index 100% rename from source/limitations.txt rename to source/limitations-upcoming.txt From d80456fb0db512e5b56a3069b42ed74f5aa13a27 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:25:42 -0500 Subject: [PATCH 03/15] edits --- source/limitations-upcoming.txt | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 8d0bcd6..d0e7d55 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -7,7 +7,7 @@ Limitations and Upcoming Features .. contents:: On this page :local: :backlinks: none - :depth: 1 + :depth: 2 :class: singlecol .. facet:: @@ -275,9 +275,9 @@ upcoming releases: ``EmbeddedModelField`` values - Creating multiple models within a collection - Using forms in embedded models -- Resolve the ``JSONField`` limitations listed in the - :ref:`Field limitations ` section of - this guide +- Resolve the ``JSONField`` limitations on ``Q`` object queries and + ``None`` value filters listed in the :ref:`Field ` limitations + section of this guide - Using a custom ``Field`` class for the ``BSONRegExp`` data type .. _django-upcoming-database: From fe105a0c106ac9d6c3c4654c5306fee180ea92b4 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:26:20 -0500 Subject: [PATCH 04/15] shorten --- source/index.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/index.txt b/source/index.txt index 4c7efbd..df10007 100644 --- a/source/index.txt +++ b/source/index.txt @@ -15,7 +15,7 @@ Django MongoDB Backend Connection Configuration Model Your Data Interact with Data - Limitations and Upcoming Features + Limitations & Upcoming Features Issues & Help Compatibility API Documentation <{+api+}> From 4d388c4b7fc4d0124ee2e44e5887550415a52396 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:29:43 -0500 Subject: [PATCH 05/15] edit intro --- source/limitations-upcoming.txt | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index d0e7d55..c3da905 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -21,15 +21,12 @@ Overview -------- On this page, you can find a list of features that -{+django-odm+} does not support. Because {+django-odm+} is in active -development, some features listed on this page might be considered for future -releases based on user demand. You can request support for a feature by leaving -a suggestion on the `Drivers Feedback Forum +{+django-odm+} does not support and features currently planned for +future releases. We will prioritize these upcoming features +based on user demand, and you can request support +for a feature by leaving a suggestion on the `Drivers Feedback Forum `__. -You can also find a list of features that {+django-odm+} -will likely support in upcoming releases. - Feature Limitations ------------------- From 2a1fa3e44bde8bb7e3ee36983f43864629fb261c Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:34:32 -0500 Subject: [PATCH 06/15] edits --- source/limitations-upcoming.txt | 66 ++++++++++++++++----------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index c3da905..285c08e 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -251,36 +251,17 @@ types of {+framework+} and MongoDB features that General Availability (GA) and post-GA {+django-odm+} releases will likely introduce: +- :ref:`django-upcoming-mongodb` - :ref:`django-upcoming-models` -- :ref:`django-upcoming-database` -- :ref:`django-upcoming-third-party` - :ref:`django-upcoming-management` +- :ref:`django-upcoming-third-party` - :ref:`django-upcoming-variables` - :ref:`django-upcoming-async` -.. _django-upcoming-models: - -Model Features -~~~~~~~~~~~~~~ - -We plan to support the following model features in -upcoming releases: - -- Creating arrays of embedded documents -- Creating polymorphic embedded documents and arrays -- Applying changes to the schema of embedded models to - ``EmbeddedModelField`` values -- Creating multiple models within a collection -- Using forms in embedded models -- Resolve the ``JSONField`` limitations on ``Q`` object queries and - ``None`` value filters listed in the :ref:`Field ` limitations - section of this guide -- Using a custom ``Field`` class for the ``BSONRegExp`` data type - -.. _django-upcoming-database: +.. _django-upcoming-mongodb: -Database Features -~~~~~~~~~~~~~~~~~ +MongodB Features +~~~~~~~~~~~~~~~~ We plan to support the following database features in upcoming releases: @@ -312,19 +293,24 @@ upcoming releases: - :manual:`Change Streams ` in the {+mdb-server+} manual -.. _django-upcoming-third-party: +.. _django-upcoming-models: -Third Party Features -~~~~~~~~~~~~~~~~~~~~ +Model Features +~~~~~~~~~~~~~~ -We plan to support the following third-party features in +We plan to support the following model features in upcoming releases: -- `Django-filter `__ -- `Django Rest Framework `__ -- `Django-allauth `__ -- `Wagtail `__ -- `Django Debug Toolbar `__ +- Creating arrays of embedded documents +- Creating polymorphic embedded documents and arrays +- Applying changes to the schema of embedded models to + ``EmbeddedModelField`` values +- Creating multiple models within a collection +- Using forms in embedded models +- Resolve the ``JSONField`` limitations on ``Q`` object queries and + ``None`` value filters listed in the :ref:`Field ` limitations + section of this guide +- Using a custom ``Field`` class for the ``BSONRegExp`` data type .. _django-upcoming-management: @@ -339,6 +325,20 @@ upcoming releases: - ``inspectdb`` - ``optimizemigration`` +.. _django-upcoming-third-party: + +Third Party Features +~~~~~~~~~~~~~~~~~~~~ + +We plan to support the following third-party features in +upcoming releases: + +- `Django-filter `__ +- `Django Rest Framework `__ +- `Django-allauth `__ +- `Wagtail `__ +- `Django Debug Toolbar `__ + .. _django-upcoming-variables: Database Variable Support From 442d453d33c4a37594b8d605b7d981379ec5a7e2 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:37:01 -0500 Subject: [PATCH 07/15] fix links --- source/limitations-upcoming.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 285c08e..b8100b3 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -284,11 +284,11 @@ upcoming releases: - :atlas:`Atlas Search ` in the Atlas documentation - :manual:`Geospatial Queries ` in the {+mdb-server+} manual - - :manual:`In-Use Encryption ` in the {+mdb-server+} + - :manual:`In-Use Encryption ` in the {+mdb-server+} manual - - :manual:`Transactions ` in the {+mdb-server+} + - :manual:`Transactions ` in the {+mdb-server+} manual - - :manual:`GridFS ` in the {+mdb-server+} + - :manual:`GridFS ` in the {+mdb-server+} manual - :manual:`Change Streams ` in the {+mdb-server+} manual From b9183d7b5d12374381b65b865f651ea9393e75a8 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:37:20 -0500 Subject: [PATCH 08/15] typo --- source/limitations-upcoming.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index b8100b3..2aa44c1 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -260,10 +260,10 @@ will likely introduce: .. _django-upcoming-mongodb: -MongodB Features +MongoDB Features ~~~~~~~~~~~~~~~~ -We plan to support the following database features in +We plan to support the following MongoDB features in upcoming releases: - Creating Vector Search, Atlas Search, and geospatial indexes From 9ebae73b10f488ec55154651fdf824844994496c Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:42:42 -0500 Subject: [PATCH 09/15] cache --- source/limitations-upcoming.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 2aa44c1..efbb8d2 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -274,6 +274,7 @@ upcoming releases: - Specifying schema validation - Using GridFS to store large files - Opening change streams to monitor your data +- Storing Django's cached data in the database .. tip:: From 5e29f7fb70eaee5aff5b9d689a04afd6b5dc7fe2 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:57:21 -0500 Subject: [PATCH 10/15] ga and post ga --- source/limitations-upcoming.txt | 34 ++++++++++++++++++++++----------- 1 file changed, 23 insertions(+), 11 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index efbb8d2..a3bde8f 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -264,17 +264,21 @@ MongoDB Features ~~~~~~~~~~~~~~~~ We plan to support the following MongoDB features in -upcoming releases: +the upcoming GA release: - Creating Vector Search, Atlas Search, and geospatial indexes - Performing Vector Search, Atlas Search, and geospatial queries - Encrypting data by using Queryable Encryption and Client-side Field Level Encryption - Running database transactions -- Using specialized aggregation operators -- Specifying schema validation +- Storing Django's cached data in the database + +We plan to support the following MongoDB features in +future post-GA releases: + - Using GridFS to store large files - Opening change streams to monitor your data -- Storing Django's cached data in the database +- Specifying schema validation +- Using specialized aggregation operators .. tip:: @@ -300,7 +304,7 @@ Model Features ~~~~~~~~~~~~~~ We plan to support the following model features in -upcoming releases: +the upcoming GA release: - Creating arrays of embedded documents - Creating polymorphic embedded documents and arrays @@ -308,7 +312,11 @@ upcoming releases: ``EmbeddedModelField`` values - Creating multiple models within a collection - Using forms in embedded models -- Resolve the ``JSONField`` limitations on ``Q`` object queries and + +We plan to support the following model features in +future post-GA releases: + +- Interacting with ``JSONField`` values without the limitations on ``Q`` object queries and ``None`` value filters listed in the :ref:`Field ` limitations section of this guide - Using a custom ``Field`` class for the ``BSONRegExp`` data type @@ -319,10 +327,14 @@ Django Management Command Features ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ We plan to support the following Django commands in -upcoming releases: +the upcoming GA release: - ``dumpdata`` - ``loaddata`` + +We plan to support the following commands in +future post-GA releases: + - ``inspectdb`` - ``optimizemigration`` @@ -332,7 +344,7 @@ Third Party Features ~~~~~~~~~~~~~~~~~~~~ We plan to support the following third-party features in -upcoming releases: +the upcoming GA release: - `Django-filter `__ - `Django Rest Framework `__ @@ -346,7 +358,7 @@ Database Variable Support ~~~~~~~~~~~~~~~~~~~~~~~~~ We plan to support the following Django variables for configuring -your database connection in upcoming releases: +your database connection in future post-GA releases: - ``CONN_HEALTH_CHECKS`` - ``TIME_ZONE`` @@ -356,5 +368,5 @@ your database connection in upcoming releases: Asynchronous Support ~~~~~~~~~~~~~~~~~~~~ -We plan to offer asynchronous support for {+django-odm+} in future -releases. \ No newline at end of file +We plan to offer asynchronous support for {+django-odm+} in +future post-GA releases. \ No newline at end of file From 7f0e722949cbf84c158b2ff457466d5f4c3c6a71 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 11:58:05 -0500 Subject: [PATCH 11/15] wording --- source/limitations-upcoming.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index a3bde8f..ac79232 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -311,7 +311,7 @@ the upcoming GA release: - Applying changes to the schema of embedded models to ``EmbeddedModelField`` values - Creating multiple models within a collection -- Using forms in embedded models +- Improving form representation in embedded models We plan to support the following model features in future post-GA releases: From 088c58ccc612d42bdcdfcb42cc20e0cd3a906f3e Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 12:56:30 -0500 Subject: [PATCH 12/15] feedback --- source/limitations-upcoming.txt | 34 +++++++++++++-------------------- 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index ac79232..4cfebe6 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -266,11 +266,13 @@ MongoDB Features We plan to support the following MongoDB features in the upcoming GA release: -- Creating Vector Search, Atlas Search, and geospatial indexes -- Performing Vector Search, Atlas Search, and geospatial queries -- Encrypting data by using Queryable Encryption and Client-side Field Level Encryption -- Running database transactions -- Storing Django's cached data in the database +- Programmatic management of Vector Search, Atlas Search, + and geospatial indexes by using the Django API +- Vector Search, Atlas Search, and geospatial queries + by using the Django API +- Queryable Encryption and Client-side Field Level Encryption +- Database transactions +- Storage of cached data in the database We plan to support the following MongoDB features in future post-GA releases: @@ -278,7 +280,6 @@ future post-GA releases: - Using GridFS to store large files - Opening change streams to monitor your data - Specifying schema validation -- Using specialized aggregation operators .. tip:: @@ -306,20 +307,17 @@ Model Features We plan to support the following model features in the upcoming GA release: -- Creating arrays of embedded documents -- Creating polymorphic embedded documents and arrays -- Applying changes to the schema of embedded models to +- Arrays of embedded documents +- Polymorphic embedded documents and arrays +- Application of changes to the embedded model schema to ``EmbeddedModelField`` values -- Creating multiple models within a collection -- Improving form representation in embedded models +- Multiple models within a collection +- Improved form representation in embedded models We plan to support the following model features in future post-GA releases: -- Interacting with ``JSONField`` values without the limitations on ``Q`` object queries and - ``None`` value filters listed in the :ref:`Field ` limitations - section of this guide -- Using a custom ``Field`` class for the ``BSONRegExp`` data type +- Custom ``Field`` class for the ``BSONRegExp`` data type .. _django-upcoming-management: @@ -332,12 +330,6 @@ the upcoming GA release: - ``dumpdata`` - ``loaddata`` -We plan to support the following commands in -future post-GA releases: - -- ``inspectdb`` -- ``optimizemigration`` - .. _django-upcoming-third-party: Third Party Features From f7f27c4830e6a826dedc17a847ca7e25cf7f706e Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 13:00:09 -0500 Subject: [PATCH 13/15] wording --- source/limitations-upcoming.txt | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 4cfebe6..c98457d 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -21,8 +21,9 @@ Overview -------- On this page, you can find a list of features that -{+django-odm+} does not support and features currently planned for -future releases. We will prioritize these upcoming features +{+django-odm+} does not support. You can also find features +currently planned for the General Availability (GA) and post-GA +releases. We will prioritize these upcoming features based on user demand, and you can request support for a feature by leaving a suggestion on the `Drivers Feedback Forum `__. @@ -243,13 +244,12 @@ please report them as shown in the :ref:`Issues & Help ` guide. You can also share your feedback on the `Drivers Feedback Forum `__. -Upcoming Features ------------------ +General Availability Release Features +------------------------------------- In this section, you can learn about the following types of {+framework+} and MongoDB features that -General Availability (GA) and post-GA {+django-odm+} releases -will likely introduce: +GA and post-GA {+django-odm+} releases will likely introduce: - :ref:`django-upcoming-mongodb` - :ref:`django-upcoming-models` @@ -264,7 +264,7 @@ MongoDB Features ~~~~~~~~~~~~~~~~ We plan to support the following MongoDB features in -the upcoming GA release: +the GA release: - Programmatic management of Vector Search, Atlas Search, and geospatial indexes by using the Django API @@ -305,7 +305,7 @@ Model Features ~~~~~~~~~~~~~~ We plan to support the following model features in -the upcoming GA release: +the GA release: - Arrays of embedded documents - Polymorphic embedded documents and arrays @@ -325,7 +325,7 @@ Django Management Command Features ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ We plan to support the following Django commands in -the upcoming GA release: +the GA release: - ``dumpdata`` - ``loaddata`` @@ -336,7 +336,7 @@ Third Party Features ~~~~~~~~~~~~~~~~~~~~ We plan to support the following third-party features in -the upcoming GA release: +the GA release: - `Django-filter `__ - `Django Rest Framework `__ From a0a89fb40e564e9619f2f5dd3e959690cae46e75 Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 13:04:13 -0500 Subject: [PATCH 14/15] verb tense --- source/limitations-upcoming.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index c98457d..4f9704d 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -277,9 +277,9 @@ the GA release: We plan to support the following MongoDB features in future post-GA releases: -- Using GridFS to store large files -- Opening change streams to monitor your data -- Specifying schema validation +- GridFS for large file storage +- Change streams for data monitoring +- Schema validation .. tip:: From d307fa015b055f408c9cf415ca5681a6499c4f0e Mon Sep 17 00:00:00 2001 From: norareidy Date: Mon, 3 Feb 2025 13:15:28 -0500 Subject: [PATCH 15/15] RR feedback 2 --- source/limitations-upcoming.txt | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/limitations-upcoming.txt b/source/limitations-upcoming.txt index 4f9704d..c015ede 100644 --- a/source/limitations-upcoming.txt +++ b/source/limitations-upcoming.txt @@ -314,10 +314,8 @@ the GA release: - Multiple models within a collection - Improved form representation in embedded models -We plan to support the following model features in -future post-GA releases: - -- Custom ``Field`` class for the ``BSONRegExp`` data type +In future post-GA releases, we plan to support a custom ``Field`` +class for the ``BSONRegExp`` data type. .. _django-upcoming-management: