DOCSP-28301-update-to-driver (#249)

* DOCSP-28301-update-to-driver

* Staging fixes

* Review Feedback

Author: Dave Cuthbert

source/changelog.txt

@@ -30,11 +30,8 @@ Compatibility Changes
   - ObjectId.prototype.get_inc
   - ObjectId.getInc
 
-- Code objects store a string in their ``.code`` property. Code objects
-  do not store JavaScript functions in their ``.code`` property.
-- If an object passes a key to a database function, ``mongosh`` only
-  sends the object's own keys to the server. ``mongosh`` does not send
-  inherited enumerable keys to the server.
+- .. include:: /includes/scripting/fact-code-objects.rst 
+- .. include:: /includes/scripting/fact-enumerable-keys.rst
 
 Updates in 1.8.0
 ~~~~~~~~~~~~~~~~

source/includes/scripting/fact-code-objects.rst

@@ -0,0 +1,3 @@
+Code objects store a string in their ``.code`` property. Code objects do
+not store JavaScript functions in their ``.code`` property.
+

source/includes/scripting/fact-enumerable-keys.rst

@@ -0,0 +1,4 @@
+If an object passes a key to a database function, ``mongosh`` only sends
+the object's own keys to the server. ``mongosh`` does not send
+inherited enumerable keys to the server.
+

source/reference/data-types.txt

@@ -52,6 +52,13 @@ operation in ``mongosh``:
 
    new ObjectId
 
+Starting in  1.8.0, the ``ObjectId`` wrapper no longer accepts:
+
+- ObjectId.prototype.generate
+- ObjectId.prototype.getInc
+- ObjectId.prototype.get_inc
+- ObjectId.getInc
+
 .. seealso::
 
    :method:`ObjectId` 

source/write-scripts.txt

@@ -475,4 +475,5 @@ you do not have to edit the script to run ``portableGetUserCount.js``.
    /write-scripts/require-external-modules
    /write-scripts/require-load-differences
    /write-scripts/scoping
-   /write-scripts/limitations
+   /write-scripts/considerations
+

source/write-scripts/limitations.txt renamed to source/write-scripts/considerations.txt

@@ -1,8 +1,9 @@
 .. _mongosh-script-limitations:
+.. _mongosh-script-considerations:
 
-==================
-Script Limitations
-==================
+=====================
+Script Considerations
+=====================
 
 .. default-domain:: mongodb
 
@@ -13,3 +14,4 @@ Script Limitations
    :class: singlecol
 
 .. include:: /includes/fact-call-limitations.rst
+