DOCSP-10430: update note on promises (#110)

Author: Chris Cho

source/usage-examples/bulkWrite.txt

@@ -6,11 +6,11 @@ Perform Bulk Operations
 
 .. note::
    If you specify a callback method, ``bulkWrite()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <BulkWriteResult.html>`.
+   do not specify one, this method returns a ``Promise`` that resolves to
+   the result object when it completes. See our guide on :doc:`Promises
+   and Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <BulkWriteResult.html>` for information on
+   the result object.
 
 The ``bulkWrite()`` method performs batch write operations against a
 *single* collection. This method reduces the number of network round trips from

source/usage-examples/command.txt

@@ -6,11 +6,11 @@ Run a Command
 
 .. note::
    If you specify a callback method, ``command()`` returns nothing. If you do
-   not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Db.html#~resultCallback>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Db.html#~resultCallback>` for
+   information on the result object.
 
 You can run all raw database operations using the :node-api:`db.command()
 <Db.html#~command>` method. Call the ``command()`` method with

source/usage-examples/deleteMany.txt

@@ -6,11 +6,11 @@ Delete Multiple Documents
 
 .. note::
    If you specify a callback method, ``deleteMany()`` returns nothing. If you 
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the 
-   :node-api:`API documentation <Collection.html#~deleteWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~deleteWriteOpResult>` for
+   information on the result object.
 
 You can delete several documents in a collection at once using the
 :node-api:`collection.deleteMany() <Collection.html#deleteMany>` method.

source/usage-examples/deleteOne.txt

@@ -6,11 +6,11 @@ Delete a Document
 
 .. note::
    If you specify a callback method, ``deleteOne()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Collection.html#~deleteWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~deleteWriteOpResult>` for
+   information on the result object.
 
 You can delete a single document in a collection with
 ``collection.deleteOne()``.

source/usage-examples/distinct.txt

@@ -6,11 +6,11 @@ Retrieve Distinct Values of a Field
 
 .. note::
    If you specify a callback method, ``distinct()`` returns nothing. If you do
-   not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Collection.html#~resultCallback>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~resultCallback>` for
+   information on the result object.
 
 You can retrieve a list of distinct values for a field across a
 collection by using the :node-api:`collection.distinct()

source/usage-examples/insertMany.txt

@@ -6,11 +6,11 @@ Insert Multiple Documents
 
 .. note::
    If you specify a callback method, ``insertMany()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the 
-   :node-api:`API documentation <Collection.html#~insertWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~insertWriteOpResult>` for
+   information on the result object.
 
 You can insert multiple documents using the :node-api:`collection.insertMany()
 <Collection.html#insertMany>` method. The ``insertMany()`` takes an array

source/usage-examples/insertOne.txt

@@ -6,11 +6,11 @@ Insert a Document
 
 .. note::
    If you specify a callback method, ``insertOne()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Collection.html#~insertOneWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~insertOneWriteOpResult>` for
+   information on the result object.
 
 You can insert a document into a collection using the
 :node-api:`collection.insertOne() <Collection.html#insertOne>` method. To

source/usage-examples/replaceOne.txt

@@ -6,11 +6,11 @@ Replace a Document
 
 .. note::
    If you specify a callback method, ``replaceOne()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Collection.html#~updateWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~updateWriteOpResult>` for
+   information on the result object.
 
 You can replace a single document using the
 :node-api:`collection.replaceOne() <Collection.html#replaceOne>` method.

source/usage-examples/updateMany.txt

@@ -6,11 +6,11 @@ Update Multiple Documents
 
 .. note::
    If you specify a callback method, ``updateMany()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the :node-api:`updateMany() API
-   documentation <Collection.html#updateMany>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~resultCallback>` for
+   information on the result object.
 
 You can update multiple documents using the
 :node-api:`updateMany() <Collection.html#updateMany>` method.

source/usage-examples/updateOne.txt

@@ -6,11 +6,11 @@ Update a Document
 
 .. note::
    If you specify a callback method, ``updateOne()`` returns nothing. If you
-   do not specify one, this method returns a
-   :mdn:`Promise <Web/JavaScript/Reference/Global_Objects/Promise>` that
-   resolves to the result object when it completes. For more information on
-   the result object type, see the
-   :node-api:`API documentation <Collection.html#~updateWriteOpResult>`.
+   not specify one, this method returns a ``Promise`` that resolves to the
+   result object when it completes. See our guide on :doc:`Promises and
+   Callbacks </fundamentals/promises>` for more information, or the
+   :node-api:`API documentation <Collection.html#~updateWriteOpResult>` for
+   information on the result object.
 
 You can update a single document using the :node-api:`collection.updateOne()
 <Collection.html#updateOne>` method. ``updateOne()`` accepts a filter