Skip to content

Commit f5dc1d5

Browse files
Nora feedback:
1 parent e0e4b5f commit f5dc1d5

File tree

1 file changed

+14
-12
lines changed

1 file changed

+14
-12
lines changed

source/limitations.txt

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -50,13 +50,14 @@ Indexes
5050

5151
{+django-odm+} does not support the following index functionalities:
5252

53-
- Creation of ``$vectorSearch`` and ``$search`` indexes through the Django
53+
- Creating ``$vectorSearch`` and ``$search`` indexes through the Django
5454
Indexes API
5555
- Creating geospatial indexes through the Django Indexes API
5656
- Updating indexes in ``EmbeddedModelFields`` after model creation
5757

5858
To learn how to run unsupported database operations by operating directly on
59-
your ``MongoClient`` instance, see the :ref:`django-client-operations` guide.
59+
your ``MongoClient`` instance, see :ref:`django-client-operations` in the
60+
Perform Raw Database Queries.
6061

6162
Fields
6263
~~~~~~
@@ -66,7 +67,7 @@ Fields
6667
- ``ArrayField``
6768

6869
- {+django-odm+} does not support ``ArrayField`` polymorphism.
69-
- {+django-odm+} does not support ``EmbeddedModelField`` within an ``ArrayField``.
70+
- {+django-odm+} does not support nesting an ``EmbeddedModelField`` within an ``ArrayField``.
7071

7172
- ``EmbeddedModelField``
7273

@@ -82,28 +83,28 @@ Fields
8283
return both JSON and SQL ``null`` values.
8384
- Some queries with ``Q`` objects, such as ``Q(value__foo="bar")``, might
8485
not work as expected.
85-
- Filtering with a ``None`` key incorrectly returns objects in which a key
86+
- Filtering for ``None`` values incorrectly returns objects in which a field
8687
does not exist.
8788

8889
- ``DateTimeField``
8990

9091
- {+django-odm+} does not support microsecond granularity for
91-
``DateTimeField``.
92+
``DateTimeField``.
9293

9394
- ``DurationField``
9495

95-
- The ``DurationField`` stores milliseconds rather than microseconds.
96+
- ``DurationField`` stores milliseconds rather than microseconds.
9697

9798
- ``ForeignKey``
9899

99100
- When possible, you should use an ``EmbeddedModelField`` instead of a
100101
``ForeignKey`` field to avoid using ``$lookup`` operations. An
101-
``EmbeddedModelField`` emulates a MongoDB embedded document, and performs
102+
``EmbeddedModelField`` emulates a MongoDB embedded document and performs
102103
better than a ``ForeignKey`` field. To learn more about how to reduce
103104
``$lookup`` operations, see the :atlas:`Reduce $lookup Operations
104105
</schema-suggestions/reduce-lookup-operations/>` guide in the Atlas
105106
documentation.
106-
- The performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#foreignkey>`__
107+
- Performance of `CASCADE deletes <{+django-docs+}/ref/models/fields/#django.db.models.CASCADE>`__
107108
on a ``ForeignKey`` field is not as performant as using an
108109
``EmbeddedModelField``.
109110

@@ -133,12 +134,13 @@ Geospatial Queries
133134
- {+django-odm+} does not have any Django lookup operators for MongoDB-specific
134135
geospatial queries.
135136

136-
Aggregation operators
137+
Aggregation Operators
137138
~~~~~~~~~~~~~~~~~~~~~
138139

139-
{+django-odm+} does not contain any custom Django Field lookups for the MongoDB
140-
aggregation framework. Instead, use the ``raw_aggregate`` method. For more
141-
information on the ``raw_aggregate`` method.
140+
{+django-odm+} does not contain any custom Django field lookups for the MongoDB
141+
aggregation framework. Instead, use the ``raw_aggregate()`` method. For more
142+
information on the ``raw_aggregate()`` method, see
143+
the :ref:`django-raw-queries` guide.
142144

143145
.. TODO: Link to aggregation
144146

0 commit comments

Comments
 (0)