feedback

Author: mongoKart

source/aggregation/aggregation-tutorials/filtered-subset.txt

@@ -90,9 +90,7 @@ Tutorial
       Next, add a :manual:`$sort
       </reference/operator/aggregation/sort>` stage that sorts the
       documents in descending order by the ``dateofbirth`` field to
-      list the youngest people first. Because Python dictionaries don't maintain the
-      order of their elements, use a ``SON``or ``OrderedDict`` object
-      instead:
+      list the youngest people first:
 
       .. literalinclude:: /includes/aggregation/filtered-subset.py
          :language: python

source/connect/mongoclient.txt

@@ -137,13 +137,13 @@ constructor accepts. All parameters are optional.
        - ``bson.raw_bson.RawBSONDocument``. To learn more about the ``RawBSONDocument`` class,
          see :ref:`pymongo-bson-raw`.
 
-       - A subclass of the ``collections.abc.Mapping`` type, such as ``bson.son.SON``. 
-         If you specify ``bson.son.SON`` as the document class, you may also specify types
-         for the key and value, as shown in the following example:
+       - A subclass of the ``collections.abc.Mapping`` type, such as ``OrderedDict``.
+         Depending on the strictness of your type-checking rules, you might also need to
+         specify types for the key and value, as shown in the following example:
 
          .. code-block:: python
 
-            client = MongoClient(document_class=SON[str, int])
+            client = MongoClient(document_class=OrderedDict[str, int])
 
        - A subclass of the ``TypedDict`` type. To pass a ``TypedDict`` subclass for this
          parameter, you must also include the class in a type hint for your ``MongoClient``

source/run-command.txt

@@ -232,9 +232,9 @@ the class name. The class can be one of the following types:
 
 - ``bson.raw_bson.RawBSONDocument``. To learn more about the ``RawBSONDocument`` class,
   see :ref:`pymongo-bson-raw`.
-- A subclass of the ``collections.abc.Mapping`` type, such as ``bson.son.SON``. 
-  If you specify ``bson.son.SON`` as the document class, you must also specify types
-  for the key and value.
+- A subclass of the ``collections.abc.Mapping`` type, such as ``OrderedDict``. 
+  Depending on the strictness of your type-checking rules, you might also need to
+  specify types for the key and value.
 - A subclass of the ``TypedDict`` type. To pass a ``TypedDict`` subclass for this
   parameter, you must also include the class in a type hint for your ``CodecOptions``
   object.