DOCSP-13863 delete many usage example

source/includes/usage-examples/code-snippets/deleteMany.go

@@ -0,0 +1,41 @@
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+
+	"go.mongodb.org/mongo-driver/bson"
+	"go.mongodb.org/mongo-driver/mongo"
+	"go.mongodb.org/mongo-driver/mongo/options"
+)
+
+// Replace the uri string with your MongoDB deployment's connection string.
+const uri = "mongodb+srv://<username>:<password>@<cluster-address>/test?w=majority"
+
+func main() {
+
+	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
+	if err != nil {
+		panic(err)
+	}
+	defer func() {
+		if err = client.Disconnect(context.TODO()); err != nil {
+			panic(err)
+		}
+	}()
+
+	// begin deleteMany
+	coll := client.Database("sample_mflix").Collection("movies")
+	filter := bson.D{{"runtime": bson.D{"$gt": 800}}}
+
+	results, err := coll.DeleteMany(context.TODO(), filter)
+	// end deleteMany
+
+	if err != nil {
+		log.Panic(err)
+	}
+
+	// When you run this file for the first time, it should print "Documents deleted: 4"
+	fmt.Printf("Documents deleted: %d\n", results.DeletedCount)
+}

source/includes/usage-examples/code-snippets/deleteOne.go

@@ -27,7 +27,9 @@ func main() {
 
 	// begin deleteOne
 	coll := client.Database("sample_mflix").Collection("movies")
-	result, err := coll.DeleteOne(context.TODO(), bson.D{{"title", "Twilight"}})
+	filter := bson.D{{"title", "Twilight"}}
+
+	result, err := coll.DeleteOne(context.TODO(), filter)
 	// end deleteOne
 
 	if err != nil {

source/usage-examples/deleteMany.txt

@@ -3,3 +3,49 @@ Delete Multiple Documents
 =========================
 
 .. default-domain:: mongodb
+
+You can delete multiple documents in a collection by using the
+``DeleteMany()`` method. 
+
+The following example specifies a query filter that matches documents in
+the ``movies`` collection where the ``runtime`` field is greater than
+*800*, and deletes all the matching documents.
+
+.. include:: /includes/usage-examples/run-example-tip.rst
+
+.. literalinclude:: /includes/usage-examples/code-snippets/deleteMany.go
+   :start-after: begin deleteMany
+   :end-before: end deleteMany
+   :emphasize-lines: 4
+   :language: go
+   :dedent:
+
+Click here <TODO> to see a fully runnable example.
+
+Expected Result
+---------------
+
+After running the preceding code snippet, you should not be able to find
+the following documents in the ``movies`` collection:
+
+.. code-block:: json
+
+    { "_id":{"$oid":"573a1397f29313caabce69db"}, ... "runtime":1256, ... },
+    { "_id":{"$oid":"573a1397f29313caabce75fe"}, ... "runtime":910, ... },
+    { "_id":{"$oid":"573a1399f29313caabcee1aa"}, ... "runtime":1140, ... },
+    { "_id":{"$oid":"573a13a6f29313caabd18ae0"}, ... "runtime":877, ... }
+
+For an example on how to find multiple documents, see our :doc:`Find
+Usage Example </usage-examples/find>`.
+
+Additional Information
+----------------------
+
+For more information on deleting documents, specifying query filters,
+and handling potential errors, see our guide on <TODO:
+Deleting a Document>.
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+`DeleteMany() <https://pkg.go.dev/go.mongodb.org/[email protected]/mongo#Collection.DeleteMany>`__

source/usage-examples/deleteOne.txt

@@ -16,7 +16,7 @@ deletes the first document that matches.
 .. literalinclude:: /includes/usage-examples/code-snippets/deleteOne.go
    :start-after: begin deleteOne
    :end-before: end deleteOne
-   :emphasize-lines: 2
+   :emphasize-lines: 4
    :language: go
    :dedent:
 

source/usage-examples/find.txt

@@ -52,5 +52,5 @@ see the :manual:`MongoDB query operator reference documentation
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
-- `Find() <https://pkg.go.dev/go.mongodb.org/[email protected]/mongo#Collection.Find>`_
-- `Cursor <https://pkg.go.dev/go.mongodb.org/[email protected]/mongo#Cursor>`_
+- `Find() <https://pkg.go.dev/go.mongodb.org/[email protected]/mongo#Collection.Find>`__
+- `Cursor <https://pkg.go.dev/go.mongodb.org/[email protected]/mongo#Cursor>`__