From 4470125fb05424e337d35c4a179348154df1c8a6 Mon Sep 17 00:00:00 2001
From: norareidy <nora.reidy@mongodb.com>
Date: Fri, 6 Sep 2024 10:07:19 -0400
Subject: [PATCH 1/5] DOCSP-41970: Delete documents

---
 source/includes/write/delete.php |  35 ++++++
 source/write.txt                 |  11 ++
 source/write/delete.txt          | 195 +++++++++++++++++++++++++++++++
 3 files changed, 241 insertions(+)
 create mode 100644 source/includes/write/delete.php
 create mode 100644 source/write.txt
 create mode 100644 source/write/delete.txt

diff --git a/source/includes/write/delete.php b/source/includes/write/delete.php
new file mode 100644
index 00000000..aa4212f9
--- /dev/null
+++ b/source/includes/write/delete.php
@@ -0,0 +1,35 @@
+<?php
+require 'vendor/autoload.php'; // Ensure you have MongoDB PHP library installed
+
+$uri = getenv('MONGODB_URI') ?: throw new RuntimeException('Set the MONGODB_URI variable to your Atlas URI that connects to the sample dataset');
+$client = new MongoDB\Client($uri);
+
+// start-db-coll
+$collection = $client->sample_restaurants->restaurants;
+// end-db-coll
+
+// Deletes a document that has a "name" value of "Ready Penny Inn"
+// start-delete-one
+$result = $collection->deleteOne(['name' => 'Ready Penny Inn']);
+// end-delete-one
+
+// Deletes documents that have a "borough" value of "Brooklyn"
+// start-delete-many
+$result = $collection->deleteMany(['borough' => 'Brooklyn']);
+// end-delete-many
+
+// Deletes matching documents and attaches a comment to the operation
+// start-delete-options
+$result = $collection->deleteMany(
+    ['name' => new MongoDB\BSON\Regex('Mongo', '')],
+    ['comment' => 'Deleting Mongo restaurants'],
+);
+// end-delete-options
+
+// Deletes and prints the number of documents that have a "cuisine" value of "Greek"
+// start-delete-count
+$result = $collection->deleteMany(['cuisine' => 'Greek']);
+echo $result->getDeletedCount() . PHP_EOL;
+// end-delete-count
+
+?>
\ No newline at end of file
diff --git a/source/write.txt b/source/write.txt
new file mode 100644
index 00000000..2e89d601
--- /dev/null
+++ b/source/write.txt
@@ -0,0 +1,11 @@
+.. _php-write:
+
+=====================
+Write Data to MongoDB
+=====================
+
+.. toctree::
+   :titlesonly:
+   :maxdepth: 1
+
+   /write/delete
\ No newline at end of file
diff --git a/source/write/delete.txt b/source/write/delete.txt
new file mode 100644
index 00000000..e42b91b4
--- /dev/null
+++ b/source/write/delete.txt
@@ -0,0 +1,195 @@
+.. _php-write-delete:
+
+================
+Delete Documents
+================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: remove, drop, code example
+
+Overview
+--------
+
+In this guide, you can learn how to use the {+php-library+} 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 ``MongoDB\Collection::deleteOne()``
+or ``MongoDB\Collection::deleteMany()`` methods.
+
+Sample Data
+~~~~~~~~~~~
+
+The examples in this guide use the ``restaurants`` collection in the ``sample_restaurants``
+database from the :atlas:`Atlas sample datasets </sample-data>`. To access this collection
+from your PHP application, instantiate a ``MongoDB\Client`` that connects to an Atlas cluster
+and assign the following value to your ``$collection`` variable:
+
+.. literalinclude:: /includes/read/delete.php
+    :language: php
+    :dedent:
+    :start-after: start-db-coll
+    :end-before: end-db-coll
+
+To learn how to create a free MongoDB Atlas cluster and load the sample datasets, see the
+:atlas:`Get Started with Atlas </getting-started>` guide.
+
+Delete Operations
+-----------------
+
+You can perform delete operations by using the following methods:
+
+- ``MongoDB\Collection::deleteOne()``, which deletes *the first document*
+  that matches the search criteria
+- ``MongoDB\Collection::deleteMany()``, which deletes *all documents* that
+  match the search criteria
+
+Each delete method requires a **query filter** document, which specifies the
+search criteria to determine which documents to select for removal.
+For more information about query filters, see the 
+:manual:`Query Filter Documents section </core/document/#query-filter-documents>` in
+the {+mdb-server+} manual.
+
+Delete One Document
+~~~~~~~~~~~~~~~~~~~
+
+The following example uses the ``deleteOne()`` method to remove a document in
+the ``restaurants`` collection that has a ``name`` value of ``'Ready Penny Inn'``:
+
+.. literalinclude:: /includes/write/delete.php
+   :start-after: start-delete-one
+   :end-before: end-delete-one
+   :language: php
+   :dedent:
+
+Delete Multiple Documents
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following example uses the ``deleteMany()`` method to remove all documents
+in the ``restaurants`` collection that have a ``borough`` value of ``'Brooklyn'``:
+
+.. literalinclude:: /includes/write/delete.php
+   :start-after: start-delete-many
+   :end-before: end-delete-many
+   :language: php
+   :dedent:
+
+Modify the Delete Operation
+---------------------------
+
+You can modify the behavior of the ``MongoDB\Collection::deleteOne()`` and
+``MongoDB\Collection::deleteMany()`` methods by by passing an array that
+specifies option values as a parameter. The following table describes the
+options you can set in the array:
+
+.. list-table::
+   :widths: 30 70
+   :header-rows: 1
+
+   * - Option
+     - Description
+
+   * - ``collation``
+     - | Specifies the kind of language collation to use when sorting
+         results. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
+         in the {+mdb-server+} manual.
+
+   * - ``writeConcern``
+     - | Sets the write concern for the operation.
+         For more information, see :manual:`Write Concern </reference/write-concern/>`
+         in the {+mdb-server+} manual.
+
+   * - ``hint``
+     - | Gets or sets the index to scan for documents. 
+         For more information, see the :manual:`hint statement </reference/command/delete/#std-label-deletes-array-hint>`
+         in the {+mdb-server+} manual.
+
+   * - ``let``
+     - | Specifies a document with a list of values to improve operation readability.
+         Values must be constant or closed expressions that don't reference document
+         fields. For more information, see the :manual:`let statement
+         </reference/command/delete/#std-label-delete-let-syntax>` in the
+         {+mdb-server+} manual.
+
+   * - ``session``
+     - | Specifies the client session to associate with the operation. For more
+         information, see :manual:`Session </reference/method/Session/>` in the
+         {+mdb-server+} manual.
+
+   * - ``comment``
+     - | Attaches a comment to the operation. For more information, see the :manual:`delete command
+         fields </reference/command/delete/#command-fields>` guide in the
+         {+mdb-server+} manual.
+
+Example
+~~~~~~~
+
+The following example calls the ``deleteMany()`` method to delete all documents in
+the ``restaurants`` collection that have a ``name`` value containing the string ``'Mongo'``.
+It also sets the ``comment`` option in an array parameter to add a comment to the
+operation:
+
+.. literalinclude:: /includes/write/delete.php
+   :start-after: start-delete-options
+   :end-before: end-delete-options
+   :language: php
+   :dedent:
+
+.. tip::
+
+   If the preceding example used the ``deleteOne()`` method instead of
+   ``deleteMany()``, the driver would delete only the first document that has
+   a ``name`` value containing ``'Mongo'``.
+
+Return Value
+------------
+
+The ``MongoDB\Collection::deleteOne()`` and ``MongoDB\Collection::deleteMany()``
+methods return a ``MongoDB\DeleteResult`` object. This class contains the
+following member functions:
+
+- ``isAcknowledged()``, which returns a boolean indicating whether the operation
+  was acknowledged
+- ``getDeletedCount()``, which returns the number of documents deleted
+
+If the query filter does not match any documents, the driver doesn't delete any
+documents and ``getDeletedCount()`` returns ``0``.
+
+Example
+~~~~~~~
+
+The following example calls the ``deleteMany()`` method to delete documents
+that have a ``cuisine`` value of ``'Greek'``. It then calls the ``getDeletedCount()``
+member function to print the number of deleted documents:
+
+.. io-code-block::
+
+   .. input:: /includes/write/delete.php
+      :start-after: start-delete-count
+      :end-before: end-delete-count
+      :language: php
+      :dedent:
+
+   .. output:: 
+
+      Deleted documents: 111
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+To learn more about any of the methods or types discussed in this
+guide, see the following API documentation:
+
+- `MongoDB\\Collection::deleteOne() <{+api+}/method/MongoDBCollection-deleteOne/>`__
+- `MongoDB\\Collection::deleteMany() <{+api+}/method/MongoDBCollection-deleteMany/>`__
+- `MongoDB\\DeleteResult <{+api+}/class/MongoDBDeleteResult/>`__

From 3a42034d0ce82141ba7a0334bd4b71d1dcc46812 Mon Sep 17 00:00:00 2001
From: norareidy <nora.reidy@mongodb.com>
Date: Fri, 6 Sep 2024 10:37:56 -0400
Subject: [PATCH 2/5] edits

---
 source/includes/write/delete.php | 5 ++---
 source/write/delete.txt          | 6 ++++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/source/includes/write/delete.php b/source/includes/write/delete.php
index aa4212f9..d1cf7eae 100644
--- a/source/includes/write/delete.php
+++ b/source/includes/write/delete.php
@@ -1,5 +1,5 @@
 <?php
-require 'vendor/autoload.php'; // Ensure you have MongoDB PHP library installed
+require 'vendor/autoload.php';
 
 $uri = getenv('MONGODB_URI') ?: throw new RuntimeException('Set the MONGODB_URI variable to your Atlas URI that connects to the sample dataset');
 $client = new MongoDB\Client($uri);
@@ -29,7 +29,6 @@
 // Deletes and prints the number of documents that have a "cuisine" value of "Greek"
 // start-delete-count
 $result = $collection->deleteMany(['cuisine' => 'Greek']);
-echo $result->getDeletedCount() . PHP_EOL;
+echo 'Deleted documents: ' . $result->getDeletedCount() . PHP_EOL;
 // end-delete-count
 
-?>
\ No newline at end of file
diff --git a/source/write/delete.txt b/source/write/delete.txt
index e42b91b4..0fe56f45 100644
--- a/source/write/delete.txt
+++ b/source/write/delete.txt
@@ -145,7 +145,7 @@ operation:
    :language: php
    :dedent:
 
-.. tip::
+.. note::
 
    If the preceding example used the ``deleteOne()`` method instead of
    ``deleteMany()``, the driver would delete only the first document that has
@@ -173,6 +173,7 @@ that have a ``cuisine`` value of ``'Greek'``. It then calls the ``getDeletedCoun
 member function to print the number of deleted documents:
 
 .. io-code-block::
+   :copyable:
 
    .. input:: /includes/write/delete.php
       :start-after: start-delete-count
@@ -181,11 +182,12 @@ member function to print the number of deleted documents:
       :dedent:
 
    .. output:: 
+      :visible: false
 
       Deleted documents: 111
 
 API Documentation
-~~~~~~~~~~~~~~~~~
+-----------------
 
 To learn more about any of the methods or types discussed in this
 guide, see the following API documentation:

From 729847713a3bfada494ea920143b116da76a4702 Mon Sep 17 00:00:00 2001
From: norareidy <nora.reidy@mongodb.com>
Date: Fri, 6 Sep 2024 10:41:50 -0400
Subject: [PATCH 3/5] vale fix

---
 source/write/delete.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/write/delete.txt b/source/write/delete.txt
index 0fe56f45..16b3199f 100644
--- a/source/write/delete.txt
+++ b/source/write/delete.txt
@@ -147,8 +147,8 @@ operation:
 
 .. note::
 
-   If the preceding example used the ``deleteOne()`` method instead of
-   ``deleteMany()``, the driver would delete only the first document that has
+   If you replace the ``deleteMany()`` method with ``deleteOne()`` in
+   the preceding example, the library deletes only the first document that has
    a ``name`` value containing ``'Mongo'``.
 
 Return Value

From 6d499f62c083b63ff72021c45f4d006c9b12b919 Mon Sep 17 00:00:00 2001
From: norareidy <nora.reidy@mongodb.com>
Date: Mon, 9 Sep 2024 15:06:03 -0400
Subject: [PATCH 4/5] code edits

---
 source/includes/write/delete.php | 2 +-
 source/write/delete.txt          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/includes/write/delete.php b/source/includes/write/delete.php
index d1cf7eae..fd3a8d73 100644
--- a/source/includes/write/delete.php
+++ b/source/includes/write/delete.php
@@ -29,6 +29,6 @@
 // Deletes and prints the number of documents that have a "cuisine" value of "Greek"
 // start-delete-count
 $result = $collection->deleteMany(['cuisine' => 'Greek']);
-echo 'Deleted documents: ' . $result->getDeletedCount() . PHP_EOL;
+echo 'Deleted documents: ' , $result->getDeletedCount() , PHP_EOL;
 // end-delete-count
 
diff --git a/source/write/delete.txt b/source/write/delete.txt
index 16b3199f..dc4fbdcd 100644
--- a/source/write/delete.txt
+++ b/source/write/delete.txt
@@ -35,7 +35,7 @@ database from the :atlas:`Atlas sample datasets </sample-data>`. To access this
 from your PHP application, instantiate a ``MongoDB\Client`` that connects to an Atlas cluster
 and assign the following value to your ``$collection`` variable:
 
-.. literalinclude:: /includes/read/delete.php
+.. literalinclude:: /includes/write/delete.php
     :language: php
     :dedent:
     :start-after: start-db-coll

From 7d0e33d9ce5949ca17de3ade7033b25a290a4743 Mon Sep 17 00:00:00 2001
From: norareidy <nora.reidy@mongodb.com>
Date: Tue, 10 Sep 2024 12:16:48 -0400
Subject: [PATCH 5/5] JM most feedback

---
 source/includes/write/delete.php |  8 ++++----
 source/write/delete.txt          | 14 ++++++++------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/source/includes/write/delete.php b/source/includes/write/delete.php
index fd3a8d73..50a5f910 100644
--- a/source/includes/write/delete.php
+++ b/source/includes/write/delete.php
@@ -10,18 +10,18 @@
 
 // Deletes a document that has a "name" value of "Ready Penny Inn"
 // start-delete-one
-$result = $collection->deleteOne(['name' => 'Ready Penny Inn']);
+$collection->deleteOne(['name' => 'Ready Penny Inn']);
 // end-delete-one
 
 // Deletes documents that have a "borough" value of "Brooklyn"
 // start-delete-many
-$result = $collection->deleteMany(['borough' => 'Brooklyn']);
+$collection->deleteMany(['borough' => 'Brooklyn']);
 // end-delete-many
 
 // Deletes matching documents and attaches a comment to the operation
 // start-delete-options
-$result = $collection->deleteMany(
-    ['name' => new MongoDB\BSON\Regex('Mongo', '')],
+$collection->deleteMany(
+    ['name' => new MongoDB\BSON\Regex('Mongo')],
     ['comment' => 'Deleting Mongo restaurants'],
 );
 // end-delete-options
diff --git a/source/write/delete.txt b/source/write/delete.txt
index dc4fbdcd..c45f16dd 100644
--- a/source/write/delete.txt
+++ b/source/write/delete.txt
@@ -88,7 +88,7 @@ Modify the Delete Operation
 ---------------------------
 
 You can modify the behavior of the ``MongoDB\Collection::deleteOne()`` and
-``MongoDB\Collection::deleteMany()`` methods by by passing an array that
+``MongoDB\Collection::deleteMany()`` methods by passing an array that
 specifies option values as a parameter. The following table describes the
 options you can set in the array:
 
@@ -100,12 +100,13 @@ options you can set in the array:
      - Description
 
    * - ``collation``
-     - | Specifies the kind of language collation to use when sorting
-         results. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
+     - | Specifies the kind of language collation to use when comparing
+         strings. For more information, see :manual:`Collation </reference/collation/#std-label-collation>`
          in the {+mdb-server+} manual.
 
    * - ``writeConcern``
-     - | Sets the write concern for the operation.
+     - | Sets the write concern for the operation. This option defaults to
+         the collection's write concern.
          For more information, see :manual:`Write Concern </reference/write-concern/>`
          in the {+mdb-server+} manual.
 
@@ -159,8 +160,9 @@ methods return a ``MongoDB\DeleteResult`` object. This class contains the
 following member functions:
 
 - ``isAcknowledged()``, which returns a boolean indicating whether the operation
-  was acknowledged
-- ``getDeletedCount()``, which returns the number of documents deleted
+  was acknowledged.
+- ``getDeletedCount()``, which returns the number of documents deleted. If the write
+  operation was not acknowledged, this method throws an error.
 
 If the query filter does not match any documents, the driver doesn't delete any
 documents and ``getDeletedCount()`` returns ``0``.