Getting Started updates for new node methods

Author: kay-kim

primer/config/primer-migrations-complex.yaml

@@ -37,11 +37,6 @@ transform:
   - regex: ":doc:`(.*) <(/reference/configuration-options)>`"
     replace: ":manual:`\\1 <\\2>`"
 ---
-source: includes/steps-configure-windows-service-for-mongodb.yaml
-transform:
-  regex: ":doc:`(.*) <(/reference/configuration-options)>`"
-  replace: ":manual:`\\1 <\\2>`"
----
 source: includes/steps-create-manually-windows-service-for-mongodb.yaml
 transform:
   regex: ":doc:`(.*) <(/reference/configuration-options)>`"
@@ -52,6 +47,16 @@ transform:
   regex: ":doc:"
   replace: ":manual:"
 ---
+source: includes/steps-get-mongodb-for-windows.yaml
+transform:
+  regex: ":doc:"
+  replace: ":manual:"
+---
+source: includes/steps-install-mongodb-on-windows-unattended.yaml
+transform:
+  regex: ":doc:"
+  replace: ":manual:"
+---
 source:  includes/fact-selinux-redhat-options.rst
 transform:
   regex: ":doc:"

primer/config/primer-migrations-simple.yaml

@@ -1,8 +1,6 @@
 override: false
 sources:
-  - includes/table-linux-kernel-version-production.yaml
   - includes/fact-installation-bind-ip-default-in-config.rst
-  - includes/note-minimum-glibc.rst
   - includes/release-base.yaml
   - includes/release-pinning.yaml
   - includes/release-specifications.yaml
@@ -35,5 +33,5 @@ sources:
   - includes/driver-table.rst
   - includes/fact-installation-directories.rst
   - includes/note-package-change.rst
-  - includes/fact-windows-unattended.rst
+  - includes/note-suse-ulimit.rst
 ...

primer/source/includes/examples-insert.yaml

@@ -153,7 +153,7 @@ operation:
        Inserted a document into the restaurants collection.
 replacement:
   insertMethod: |
-    `insert <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#insert>`_
+    `insertOne <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#insertOne>`_
 ---
 source:
   file: examples-insert-base.yaml

primer/source/includes/examples-remove.yaml

@@ -157,13 +157,13 @@ post: |
    The operation prints to the console the number of documents removed.
 replacement:
   removeMethod: |
-    `remove() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#remove>`_
+    `deleteMany() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#deleteMany>`_
 ---
 source:
   file: examples-remove-base.yaml
   ref: _remove-justOne
 ref: remove-justOne
-title: "Use the ``single`` Option"
+title: "Remove just one document."
 edition: node
 operation:
   - pre: |
@@ -194,7 +194,7 @@ post: |
    The operation prints to the console the number of documents removed.
 replacement:
   removeMethod: |
-    `remove() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#remove>`_
+    `deleteOne() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#deleteOne>`_
 ---
 source:
   file: examples-remove-base.yaml
@@ -207,7 +207,7 @@ operation:
     language: javascript
     code: |
       var removeRestaurants = function(db, callback) {
-         db.collection('restaurants').removeMany( {}, function(err, results) {
+         db.collection('restaurants').deleteMany( {}, function(err, results) {
             console.log(results);
             callback();
          });
@@ -227,7 +227,7 @@ post: |
    The operation prints to the console the number of documents removed.
 replacement:
   removeMethod: |
-    `remove() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#remove>`_
+    `deleteMany() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#deleteMany>`_
 ---
 source:
   file: examples-remove-base.yaml

primer/source/includes/examples-update-fields.yaml

@@ -165,7 +165,7 @@ post: |
    The {{updateMethod}} returns the number of documents updated. 
 replacement:
   updateMethod: |
-    `update() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#update>`_
+    `updateOne() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#updateOne>`_
 ---
 source:
   file: examples-update-fields-base.yaml
@@ -201,13 +201,21 @@ post: |
    The {{updateMethod}} returns the number of documents updated. 
 replacement:
   updateMethod: |
-    `update() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#update>`_
+    `updateOne() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#updateOne>`_
 ---
 source:
   file: examples-update-fields-base.yaml
   ref: _update-multiple-documents
 ref: update-multiple-documents
 edition: node
+pre: |
+pre: |
+  To update multiple documents, use the {{updateMethod}} method.
+
+  The following operation updates *all* documents that have
+  ``address.zipcode`` field equal to ``"10016"``, setting the ``borough``
+  field to ``"Midtown"`` and the ``lastModified`` field to the current
+  date.
 operation:
   - pre: |
       Define an ``updateRestaurants`` function as follows:
@@ -240,7 +248,7 @@ post: |
    The {{updateMethod}} returns the number of documents updated. 
 replacement:
   updateMethod: |
-    `update() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#update>`_
+    `updateMany() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#updateMany>`_
 ---
 source:
   file: examples-update-fields-base.yaml

primer/source/includes/examples-update-replace.yaml

@@ -99,7 +99,7 @@ post: |
    The {{updateMethod}} returns the number of documents updated. 
 replacement:
   updateMethod: |
-    `update() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#update>`_
+    `replaceOne() <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#replaceOne>`_
 ---
 source:
   file: examples-update-replace-base.yaml

primer/source/includes/extracts-insert-overview.yaml

@@ -8,15 +8,15 @@ edition: shell
 ---
 ref: insert-overview
 replacement:
-  insert: :py:meth:`~pymongo.collection.Collection.insert()`
+  insert: :py:meth:`~pymongo.collection.Collection.insertOne()` and the :py:meth:`~pymongo.collection.Collection.insertMany()`
 inherit:
   ref: _insert-overview
   file: extracts-insert-overview-base.yaml
 edition: python
 ---
 ref: insert-overview
 replacement:
-  insert: "`insert <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#insert>`_"
+  insert: "`insertOne <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#insertOne>`_ method and the `insertMany <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#insert>`_"
 inherit:
   ref: _insert-overview
   file: extracts-insert-overview-base.yaml

primer/source/includes/extracts-remove-overview.yaml

@@ -16,7 +16,7 @@ edition: python
 ---
 ref: remove-overview
 replacement:
-  remove: "`remove <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#remove>`_"
+  remove: "`deleteOne <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#deleteOne>`_ method and the `deleteMany <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#deleteMany>`_"
 inherit:
   ref: _remove-overview
   file: extracts-remove-overview-base.yaml

primer/source/includes/extracts-update-overview.yaml

@@ -16,11 +16,13 @@ edition: python
 ---
 ref: update-overview
 replacement:
-  update: "`update <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#update>`_"
+  update: "`updateOne <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#updateOne>`_ method, `updateMany <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#updateMany>`_ method, and `replaceOne <http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#replaceOne>`_"
 inherit:
   ref: _update-overview
   file: extracts-update-overview-base.yaml
 edition: node
+post: |
+   You cannot update the ``_id`` field.
 ---
 ref: update-overview
 replacement:

primer/source/includes/extracts-update-replace-overview-base.yaml

@@ -0,0 +1,15 @@
+ref: _update-replace-overview
+content: |
+   To replace the **entire** document except for the ``_id`` field, pass
+   an entirely new document as the second argument to the
+   {{update}} method. The replacement document can have
+   different fields from the original document. In the replacement
+   document, you can omit the ``_id`` field since the ``_id`` field is
+   immutable. If you do include the ``_id`` field, it must be the same
+   value as the existing value.
+post: |
+   .. important::
+      After the update, the document **only** contains the field or
+      fields in the replacement document.
+
+...