RM feedback

Author: mcmorisi

source/data-formats/bson.txt

@@ -52,13 +52,13 @@ represents the preceding sample BSON document:
 .. code-block:: python
 
    document = {
-       'address': {
-           'street': 'Pizza St',
-           'zipcode': '10003'
+       "address": {
+           "street": "Pizza St",
+           "zipcode": "10003"
        },
-       'coord': [-73.982419, 41.579505],
-       'cuisine': 'Pizza',
-       'name': 'Mongo's Pizza'
+       "coord": [-73.982419, 41.579505],
+       "cuisine": "Pizza",
+       "name": "Mongo's Pizza"
    }
 
 Change a BSON Document
@@ -70,39 +70,36 @@ BSON document:
 
 1. Adds a new field, ``restaurant_id``, with the value ``12345``
 #. Removes the ``cuisine`` field
-#. Sets the value of the ``name`` field to ``'Mongo's Pizza Place'``
+#. Sets the value of the ``name`` field to ``"Mongo's Pizza Place"``
 
 .. code-block:: python
 
-   document['restaurant_id'] = 12345
-   del document['cuisine']
-   document['name'] = 'Mongo's Pizza Place'   
+   document["restaurant_id"] = 12345
+   del document["cuisine"]
+   document["name"] = "Mongo's Pizza Place"   
 
 Write BSON to a File
 --------------------
 
-To write BSON data to a file, perform the following steps:
-
-1. Fetch the documents you want to write to a file.
-#. Open a file stream on the file to write to in write-binary mode.
-#. Write each document to the output file. Ensure that documents are encoded to BSON
-   format by using the ``BSON.encode()`` method.
+To write BSON data to a file, open a file stream to in write-binary mode on the output file.
+Then, write each document to the output file. Ensure that documents are encoded in BSON
+format by using the ``BSON.encode()`` method.
 
 The following example writes the sample BSON document to ``file.bson``:
 
 .. code-block:: python
 
    import bson
 
-   with open('file.bson', 'w') as file:
+   with open("file.bson", "w") as file:
        file.write(BSON.encode(document))
 
 Read BSON from a File
 ---------------------
 
-To read BSON documents from a file, open a file stream on the file to read from in
-read-binary mode, then read the documents from the file. Ensure that the documents are
-decoded from BSON format by using the ``BSON.decode()`` method.
+To read BSON documents from a file, open a file stream in read-binary mode on the input
+file. Then, decode the documents from BSON format as you read them by using the ``BSON.decode()``
+method.
 
 The following example reads the sample BSON document from ``file.bson``:
 
@@ -112,20 +109,18 @@ The following example reads the sample BSON document from ``file.bson``:
    .. input::
       :language: python
 
-         with open('file.bson', 'rb') as file:
+         with open("file.bson", "rb") as file:
              data = file.read()
              document = BSON(data).decode()
              print(document)
 
    .. output::
       :visible: false
 
-      {'address': {'street': 'Pizza St', 'zipcode': '10003'}, 'coord': [-73.982419, 41.579505], 'cuisine': 'Pizza', 'name': "Mongo's Pizza"}
+      {"address": {"street": "Pizza St", "zipcode": "10003"}, "coord": [-73.982419, 41.579505], "cuisine": "Pizza", "name": "Mongo's Pizza"}
 
 API Documentation
 -----------------
 
 To learn more about any of the methods or types discussed in this
-guide, see the following API documentation:
-
-- `bson <{+api-root+}bson/index.html>`__
+guide, see the `bson <{+api-root+}bson/index.html>`__ API documentation.