small fixes

Author: mongoKart

source/compatibility.txt

@@ -50,5 +50,5 @@ The first column lists the driver version.
 
 .. include:: /includes/language-compatibility-table-pymongo.rst
 
-For more information on how to read the compatibility tables, see our guide on 
+For more information about how to read the compatibility tables, see
 :ref:`MongoDB Compatibility Tables. <about-driver-compatibility>`

source/includes/language-compatibility-table-pymongo.rst

@@ -212,53 +212,8 @@ as binary data with subtype 0, the default subtype for binary data. In Python 3,
 {+driver-short+} decodes these values to instances of the ``bytes`` class. In Python 2,
 the driver decodes them to instances of the
 `Binary <https://pymongo.readthedocs.io/en/4.11/api/bson/binary.html#bson.binary.Binary>`__
-class with subtype 0.
-
-The following code examples show how {+driver-short+} decodes instances of the ``bytes``
-class. Select the :guilabel:`Python 2` or :guilabel:`Python 3` tab to view the corresponding
-code.
-
-.. tabs::
-
-   .. tab:: Python 2
-      :tabid: python2
-
-      .. io-code-block::
-         :copyable: true
-
-         .. input::
-            :language: python
-
-            from pymongo import MongoClient
-
-            client = MongoClient()
-            client.test.test.insert_one({'binary': b'this is a byte string'})
-            doc = client.test.test.find_one()
-            print(doc)
-          
-         .. output::
-
-            {u'_id': ObjectId('67afb78298f604a28f0247b4'), u'binary': Binary('this is a byte string', 0)}
-
-   .. tab:: Python 3
-      :tabid: python3
-
-      .. io-code-block::
-         :copyable: true
-
-         .. input::
-            :language: python
-
-            from pymongo import MongoClient
-
-            client = MongoClient()
-            client.test.test.insert_one({'binary': b'this is a byte string'})
-            doc = client.test.test.find_one()
-            print(doc)
-
-         .. output::
-
-            {'_id': ObjectId('67afb78298f604a28f0247b4'), 'binary': b'this is a byte string'}
+class with subtype 0. For code examples that show the differences, see the
+:ref:`Extended JSON <pymongo-serialization-binary-data>` page.
 
 The driver behaves the same way when decoding JSON binary values with subtype 0. In
 Python 3, it decodes these values to instances of the ``bytes`` class. In Python 2,

source/read/retrieve.txt

@@ -83,8 +83,6 @@ the ``"cuisine"`` field has the value ``"Bakery"``:
 
    To learn more about sorting, see the :ref:`sort guide <pymongo-sort>`.
 
-
-
 .. _pymongo-retrieve-find-multiple:
 
 Find Multiple Documents

source/serialization.txt

@@ -91,44 +91,61 @@ it back into a ``Restaurant`` object from the preceding example:
 To learn more about retrieving documents from a collection, see the :ref:`pymongo-retrieve`
 guide.
 
-Binary Fields
--------------
+.. _pymongo-serialization-binary-data:
+
+Binary Data
+-----------
 
 In all versions of Python, {+driver-short+} encodes instances of the
 `bytes <https://docs.python.org/3/library/stdtypes.html#bytes>`__ class
 as binary data with subtype 0, the default subtype for binary data. In Python 3,
 {+driver-short+} decodes these values to instances of the ``bytes`` class. In Python 2,
-however, the driver decodes them to instances of the
+the driver decodes them to instances of the
 `Binary <https://pymongo.readthedocs.io/en/4.11/api/bson/binary.html#bson.binary.Binary>`__
 class with subtype 0.
 
-The following code examples use {+driver-short+} to insert a ``bytes`` instance
-into MongoDB, and then find the instance.
-In Python 2, the byte string is decoded to ``Binary``.
-In Python 3, the byte string is decoded back to ``bytes``.
+The following code examples show how {+driver-short+} decodes instances of the ``bytes``
+class. Select the :guilabel:`Python 2` or :guilabel:`Python 3` tab to view the corresponding
+code.
 
 .. tabs::
 
-   .. tab:: Python 2.7
-      :tabid: python-2
+   .. tab:: Python 2
+      :tabid: python2
 
-      .. code-block:: python
+      .. io-code-block::
+         :copyable: true
 
-         >>> import pymongo
-         >>> c = pymongo.MongoClient()
-         >>> c.test.bintest.insert_one().inserted_id
-         ObjectId('4f9086b1fba5222021000000')
-         >>> c.test.bintest.find_one()
-         {u'binary': Binary('this is a byte string', 0), u'_id': ObjectId('4f9086b1fba5222021000000')}
- 
-   .. tab:: Python 3.7
-      :tabid: python-3
+         .. input::
+            :language: python
+
+            from pymongo import MongoClient
+
+            client = MongoClient()
+            client.test.test.insert_one({'binary': b'this is a byte string'})
+            doc = client.test.test.find_one()
+            print(doc)
+          
+         .. output::
+
+            {u'_id': ObjectId('67afb78298f604a28f0247b4'), u'binary': Binary('this is a byte string', 0)}
+
+   .. tab:: Python 3
+      :tabid: python3
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input::
+            :language: python
+
+            from pymongo import MongoClient
+
+            client = MongoClient()
+            client.test.test.insert_one({'binary': b'this is a byte string'})
+            doc = client.test.test.find_one()
+            print(doc)
 
-      .. code-block:: python
+         .. output::
 
-         >>> import pymongo
-         >>> c = pymongo.MongoClient()
-         >>> c.test.bintest.insert_one({'binary': b'this is a byte string'}).inserted_id
-         ObjectId('4f9086b1fba5222021000000')
-         >>> c.test.bintest.find_one()
-         {'binary': b'this is a byte string', '_id': ObjectId('4f9086b1fba5222021000000')}
+            {'_id': ObjectId('67afb78298f604a28f0247b4'), 'binary': b'this is a byte string'}