JB feedback

Author: rachel-mack

source/data-formats/extended-json.txt

@@ -24,11 +24,11 @@ Read Extended JSON
 ------------------
 
 You can read an Extended JSON string into an Ruby array by calling
-the ``BSON::ExtJSON.parse()`` method. This method parses an Extended
+the ``BSON::ExtJSON.parse`` method. This method parses an Extended
 JSON string and returns an array containing the data.
 
 The following example shows how you can read an Extended JSON string into a
-array of hashes by using the ``parse()`` method:
+array of hashes by using the ``parse`` method:
 
 .. io-code-block::
     :copyable:
@@ -51,10 +51,9 @@ array of hashes by using the ``parse()`` method:
 Write Extended JSON
 -------------------
 
-You can write an Extended JSON string from a hash by using the
-``as_extended_json()`` method. By default, this method returns
-the Extended JSON string in canonical format, but you can specify relaxed or
-legacy formats by passing a ``mode`` argument. 
+You can write an Extended JSON string by using the ``as_extended_json``
+method. By default, this method returns the Extended JSON string in canonical
+format, but you can specify relaxed or legacy formats by passing a ``mode`` argument. 
 
 .. note:: Legacy Version
 
@@ -65,9 +64,9 @@ legacy formats by passing a ``mode`` argument.
    For more information see, the :manual:`MongoDB Extended JSON v1
    </reference/mongodb-extended-json-v1/>` page in the Server manual. 
 
-The following example outputs an Extended JSON string in the canonical, relaxed,
-and legacy formats. It calls the ``as_extended_json()`` method from inside a
-Ruby ``map{}`` block to create the Extended JSON string from an array of hashes:
+The ``as_extended_json`` method is available for many other core and
+standard library types. The following example creates Extended JSON strings in
+the canonical, relaxed, and legacy formats, from an array of hashes:
 
 .. io-code-block::
     :copyable:
@@ -94,8 +93,8 @@ For more information, see the following resources:
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-- `BSON::ExtJSON.parse() <https://www.rubydoc.info/gems/bson/{+bson-version+}/BSON/ExtJSON#parse-class_method>`__
-- `#as_extended_json() <https://www.rubydoc.info/gems/bson/{+bson-version+}/BSON/Hash#as_extended_json-instance_method>`__
+- `BSON::ExtJSON.parse <https://www.rubydoc.info/gems/bson/{+bson-version+}/BSON/ExtJSON#parse-class_method>`__
+- `#as_extended_json <https://www.rubydoc.info/gems/bson/{+bson-version+}/BSON/Array#as_extended_json-instance_method>`__
 
 Server Manual Pages
 ~~~~~~~~~~~~~~~~~~~

source/includes/data-formats/extended-json.rb

@@ -29,13 +29,9 @@
     { "number" => BSON::Int64.new(42) }
 ]
 
-json_array_canonical = hash_array.map(&:as_extended_json)
-json_array_relaxed = hash_array.map{ |hash| hash.as_extended_json(mode: :relaxed) }
-json_array_legacy = hash_array.map{ |hash| hash.as_extended_json(mode: :legacy) }
-
-json_string_canonical = JSON.generate(json_array_canonical)
-json_string_relaxed = JSON.generate(json_array_relaxed)
-json_string_legacy = JSON.generate(json_array_legacy)
+json_string_canonical = hash_array.as_extended_json
+json_string_relaxed = hash_array.as_extended_json(mode: :relaxed)
+json_string_legacy = hash_array.as_extended_json(mode: :legacy)
 
 puts "canonical:\t #{json_string_canonical}"
 puts "relaxed:\t #{json_string_relaxed}"