first pass fixes

Author: rustagir

source/write/delete.txt

@@ -24,8 +24,8 @@ In this guide, you can learn how to use the {+driver-short+} to remove
 documents from a MongoDB collection by performing **delete operations**.
 
 A delete operation removes one or more documents from a MongoDB collection.
-You can perform a delete operation by using the ``delete_one()`` or
-``delete_many()`` methods.
+You can perform a delete operation by using the ``deleteOne()`` or
+``deleteMany()`` methods.
 
 .. TODO .. tip:: Interactive Lab
 
@@ -54,6 +54,7 @@ The documents in this collection are modeled by the following {+language+} data
    :end-before: end-data-class
    :language: kotlin
    :copyable:
+   :dedent:
 
 Delete Operations
 -----------------
@@ -80,6 +81,7 @@ document in which the value of the ``name`` field is ``"Happy Garden"``:
    :end-before: end-delete-one
    :language: kotlin
    :copyable:
+   :dedent:
 
 Delete Multiple Documents
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -93,6 +95,7 @@ value of the ``name`` field is ``"Starbucks"``:
    :end-before: end-delete-many
    :language: kotlin
    :copyable:
+   :dedent:
 
 Customize the Delete Operation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -141,17 +144,18 @@ configure a ``DeleteOptions`` instance:
          fields </reference/command/delete/#command-fields>` guide in the
          {+mdb-server+} manual for more information.
 
-The following code uses the ``deleteMany()`` method to delete all
-documents in the ``restaurants`` collection in which the value of the
-``name`` field includes the string ``"Red"``. The example also uses the
-``comment()`` method to add a comment to the operation and passes the
-resulting ``DeleteOptions`` instance to the ``deleteMany()`` method:
+The following code creates options and uses the ``comment()`` method to
+add a comment to the delete operation. Then, the example uses the
+``deleteMany()`` method to delete all documents in the ``restaurants``
+collection in which the value of the ``name`` field includes the string
+``"Red"``.
 
 .. literalinclude:: /includes/write/delete.kt
    :start-after: start-delete-options
    :end-before: end-delete-options
    :language: kotlin
    :copyable:
+   :dedent:
 
 .. tip::
 
@@ -170,6 +174,9 @@ a ``DeleteResult`` instance:
 - ``wasAcknowledged()``, which returns ``true`` if the server
   acknowledges the result
 
+If the query filter does not match any documents, the driver doesn't delete any
+documents and the value of ``deletedCount`` is ``0``.
+
 .. note::
 
    If the ``wasAcknowledged()`` method returns ``false``, trying to
@@ -178,17 +185,14 @@ a ``DeleteResult`` instance:
    determine these values if the server does not acknowledge the write
    operation.
 
-If the query filter does not match any documents, the driver doesn't delete any
-documents and ``deletedCount`` is ``0``.
-
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
 To learn more about any of the methods or types discussed in this
 guide, see the following API Documentation:
 
 - `deleteOne() <{+api+}/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client/-mongo-collection/delete-one.html>`__
-- `deleteOne() <{+api+}/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client/-mongo-collection/delete-many.html>`__
+- `deleteMany() <{+api+}/mongodb-driver-kotlin-sync/com.mongodb.kotlin.client/-mongo-collection/delete-many.html>`__
 - `DeleteResult <{+core-api+}/com/mongodb/client/result/DeleteResult.html>`__
 
 .. .. _kotlin-sync-delete-instruqt-lab: