add changes discussed with vk over slack

Author: shuangela

source/tutorials/write-update-documents.txt

@@ -95,10 +95,12 @@ Update One Document
 -------------------
 
 To update a single document in a MongoDB collection, call the ``updateOne()``
-method and pass your query filter and update operators. Then, pass the ``updateOne()`` result to the static ``Mono.from()`` method from the
-``Mono Publisher``. The ``Mono Publisher`` is a ``Publisher`` implementation
-from the Project Reactor library. In {+java-rs+}, you must use ``Publisher``
-implementations to control how data is transmitted in your application. To learn more
+method and pass your query filter and update operators. Then, pass the
+``updateOne()`` result to the static ``Mono.from()`` method from
+``Mono``. ``Mono`` is a class from the Project Reactor library. In {+java-rs+}, 
+the driver methods return cold ``Publisher``s, which means that the
+corresponding operation does not happen unless you subscribe to the returned
+``publisher``. This guide uses the Project Reactor library to consume them.To learn more
 about ``Mono``, see `Mono <https://projectreactor.io/docs/core/release/reference/#mono>`__ in the Project
 Reactor documentation.
 
@@ -117,10 +119,11 @@ Update Multiple Documents
 -------------------------
 
 To update multiple documents in a MongoDB collection, call the ``updateMany()``
-method and pass your query filter and update operators. Then, pass the ``updateMany()`` result to the static ``Mono.from`` method from the
-``Mono Publisher``. The ``Mono Publisher`` is a ``Publisher`` implementation
-from the Project Reactor library. In {+java-rs+}, you must use ``Publisher``
-implementations to control how data is transmitted in your application. To learn more
+method and pass your query filter and update operators. Then, pass the ``updateMany()`` result to the static ``Mono.from()`` method from
+``Mono``. ``Mono`` is a class from the Project Reactor library. In {+java-rs+}, 
+the driver methods return cold ``Publisher``s, which means that the
+corresponding operation does not happen unless you subscribe to the returned
+``publisher``. This guide uses the Project Reactor library to consume them.To learn more
 about ``Mono``, see `Mono <https://projectreactor.io/docs/core/release/reference/#mono>`__ in the Project
 Reactor documentation.
 

source/write-data-to-mongo.txt

@@ -33,6 +33,8 @@ Write Data to MongoDB
 Overview
 --------
 
+.. _write-data-reactor-overview:
+
 This page contains copyable code examples of {+driver-short+} methods that you can use to
 write data to MongoDB.