DOCS-4884: Mention MongoDB 3.0 upsert changes

Author: i80and

source/includes/apiargs-method-db.collection.update-param.yaml

@@ -1,8 +1,13 @@
 arg_name: param
 description: |
-  The selection criteria for the update. Use the same :ref:`query
-  selectors <query-selectors>` as used in the :method:`find()
-  <db.collection.find()>` method.
+  The selection criteria for the update. The same :ref:`query
+  selectors <query-selectors>` as in the :method:`find()
+  <db.collection.find()>` method are available.
+
+  .. versionchanged:: 3.0
+
+     .. include:: /includes/fact-mongodb30-upsert-id.rst
+
 interface: method
 name: query
 operation: db.collection.update

source/includes/fact-mongodb30-upsert-id.rst

@@ -0,0 +1,8 @@
+When you execute an upsert, you can no longer use dot notation to only select
+on part of the ``_id`` field. For example, the following will raise an error:
+
+.. code-block:: javascript
+
+   db.collection.update( { "_id.name": "Robert"},
+      { _id: { "name": "Robert Frost" } },
+      { upsert: true } )

source/release-notes/3.0-compatibility.txt

@@ -475,6 +475,11 @@ The minimum 3.0-compatible driver versions are:
 General Compatibility Changes
 -----------------------------
 
+Upserts and ``_id``
+~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-mongodb30-upsert-id.rst
+
 Deprecate Access to ``system.indexes`` and ``system.namespaces``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

source/tutorial/modify-documents.txt

@@ -44,7 +44,7 @@ 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.
-  
+
 .. include:: /includes/steps/getting-started-update-replace.rst
 
 ``upsert`` Option