DOCSP-26447: use struct in write ops (mongodb#224)

* DOCSP-26447: use struct in write ops -- BULK OPS pg

* DELETE pg + fixes

* ARRAY PG + fixes

* INSERT PG + fixes

* UPSERT PG

* JS PR fixes 1

Author: rustagir

source/fundamentals/crud/write-operations.txt

@@ -10,7 +10,7 @@ Write Operations
 - :ref:`golang-delete-guide`
 - :ref:`golang-change-document`
 - :ref:`golang-update-arrays`
-- :ref:`golang-upsert`
+- :ref:`golang-upsert-guide`
 - :ref:`golang-bulk`
 
 .. toctree::

source/fundamentals/crud/write-operations/bulk.txt

@@ -24,23 +24,35 @@ perform multiple operations with one call to the database.
 Sample Data
 ~~~~~~~~~~~
 
-To run the example in this guide, load the sample data into the
-``tea.ratings`` collection with the following
-snippet:
+The examples in this guide use the following ``Book`` struct as a model for documents
+in the ``books`` collection:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/CRUD/bulkOps.go
+   :start-after: start-book-struct
+   :end-before: end-book-struct
    :language: go
    :dedent:
-   :start-after: begin insert docs
-   :end-before: end insert docs
 
-.. include:: /includes/fundamentals/tea-sample-data-ending.rst
+To run the examples in this guide, load the sample data into the
+``db.books`` collection with the following snippet:
+
+.. literalinclude:: /includes/fundamentals/code-snippets/CRUD/bulkOps.go
+   :language: go
+   :dedent:
+   :start-after: begin insertDocs
+   :end-before: end insertDocs
+
+Each document contains a description of a book that
+includes the title, author, and page length corresponding to
+the ``title``, ``author``, and ``length`` fields in each document.
+
+.. include:: /includes/fundamentals/automatic-db-coll-creation.rst
 
 Bulk Write
 ----------
 
-To perform a bulk operation, pass a slice of :ref:`WriteModel
-<golang-write-model>` documents to the ``BulkWrite()`` method. 
+To perform a bulk operation, pass an array of :ref:`WriteModel
+<golang-write-model>` documents to the ``BulkWrite()`` method.
 
 Modify Behavior
 ~~~~~~~~~~~~~~~
@@ -176,8 +188,7 @@ Example
 ```````
 
 The following example creates a ``ReplaceOneModel`` to replace a
-document where the ``type`` is "Earl Grey" with a document where the
-``type`` is "Matcha" and the ``rating`` is ``8``:
+document where the ``title`` is "Lucy" with a new document:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/CRUD/bulkOps.go
    :language: go
@@ -225,7 +236,7 @@ Example
 ```````
 
 The following example creates an ``UpdateOneModel`` to decrement a
-documents ``rating`` by ``2`` if their ``type`` is "Masala":
+document's ``length`` by ``15`` if the ``author`` is "Elena Ferrante":
 
 .. literalinclude:: /includes/fundamentals/code-snippets/CRUD/bulkOps.go
    :language: go
@@ -263,7 +274,7 @@ Example
 ```````
 
 The following example creates a ``DeleteManyModel`` to delete
-documents where the ``rating`` is greater than ``7``:
+documents where the ``length`` is greater than ``300``:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/CRUD/bulkOps.go
    :language: go
@@ -306,9 +317,10 @@ Example
 The following example performs the following actions in any order: 
 
 - Inserts two documents.
-- Replaces a document where the type is "Earl Grey" with a new document.
-- Increments all documents ``rating`` by ``3`` if their current rating is less than ``7``.
-- Deletes all documents where the rating is ``9``.
+- Replaces a document where the ``title`` is "My Brilliant Friend" with a new document.
+- Increments every document's ``length`` by ``10`` if the current
+  ``length`` value is less than ``200``.
+- Deletes all documents where the ``author`` field value includes "Jam".
 
 .. io-code-block::
    :copyable: true
@@ -317,16 +329,16 @@ The following example performs the following actions in any order:
       :language: go
 
       models := []mongo.WriteModel{
-         mongo.NewInsertOneModel().SetDocument(bson.D{{"type", "Oolong"}, {"rating", 9}}),
-         mongo.NewInsertOneModel().SetDocument(bson.D{{"type", "Assam"}, {"rating", 6}}),
-         mongo.NewReplaceOneModel().SetFilter(bson.D{{"type", "Earl Grey"}}).
-            SetReplacement(bson.D{{"type", "Matcha"}, {"rating", 4}}),
-         mongo.NewUpdateManyModel().SetFilter(bson.D{{"rating", bson.D{{"$lt", 7}}}}).
-            SetUpdate(bson.D{{"$inc", bson.D{{"rating", 3}}}}),
-         mongo.NewDeleteManyModel().SetFilter(bson.D{{"rating", 9}}),
+        mongo.NewInsertOneModel().SetDocument(Book{Title: "Middlemarch", Author: "George Eliot", Length: 904}),
+        mongo.NewInsertOneModel().SetDocument(Book{Title: "Pale Fire", Author: "Vladimir Nabokov", Length: 246}),
+        mongo.NewReplaceOneModel().SetFilter(bson.D{{"title", "My Brilliant Friend"}}).
+      	  SetReplacement(Book{Title: "Atonement", Author: "Ian McEwan", Length: 351}),
+        mongo.NewUpdateManyModel().SetFilter(bson.D{{"length", bson.D{{"$lt", 200}}}}).
+      	  SetUpdate(bson.D{{"$inc", bson.D{{"length", 10}}}}),
+        mongo.NewDeleteManyModel().SetFilter(bson.D{{"author", bson.D{{"$regex", "Jam"}}}}),
       }
       opts := options.BulkWrite().SetOrdered(false)
-
+      
       results, err := coll.BulkWrite(context.TODO(), models, opts)
       if err != nil {
          panic(err)
@@ -341,17 +353,18 @@ The following example performs the following actions in any order:
       :visible: false
 
       Number of documents inserted: 2
-      Number of documents replaced or updated: 3
-      Number of documents deleted: 2
+      Number of documents replaced or updated: 2
+      Number of documents deleted: 1
 
 The following documents are present in the ``ratings`` collection after
 the bulk operation:
 
 .. code-block:: none
    :copyable: false
 
-   [{_id ObjectID("...")} {type Masala} {rating 10}]
-   [{_id ObjectID("...")} {type Matcha} {rating 7}]
+   {"title":"Atonement","author":"Ian McEwan","length":351}
+   {"title":"Middlemarch","author":"George Eliot","length":904}
+   {"title":"Pale Fire","author":"Vladimir Nabokov","length":246}
 
 Additional Information
 ----------------------

source/fundamentals/crud/write-operations/delete.txt

@@ -21,20 +21,29 @@ collections using delete operations.
 Sample Data
 ~~~~~~~~~~~
 
-To run the example in this guide, load these documents into the
-``tea.ratings`` collection with the following
-snippet:
+The examples in this guide use the following ``Book`` struct as a model for documents
+in the ``books`` collection:
+
+.. literalinclude:: /includes/fundamentals/code-snippets/CRUD/delete.go
+   :start-after: start-book-struct
+   :end-before: end-book-struct
+   :language: go
+   :dedent:
+
+To run the examples in this guide, load the sample data into the
+``db.books`` collection with the following snippet:
 
 .. literalinclude:: /includes/fundamentals/code-snippets/CRUD/delete.go
    :language: go
    :dedent:
    :start-after: begin insertDocs
    :end-before: end insertDocs
 
-.. include:: /includes/fundamentals/automatic-db-coll-creation.rst
+Each document contains a description of a book that
+includes the title, author, and page length corresponding to
+the ``title``, ``author``, and ``length`` fields in each document.
 
-Each document contains a rating for a type of tea, which corresponds to
-the ``type`` and ``rating`` fields.
+.. include:: /includes/fundamentals/automatic-db-coll-creation.rst
 
 Delete Operations
 -----------------
@@ -94,16 +103,16 @@ Example
 The following example performs the following with the ``DeleteMany()``
 method:
 
-- Matches and deletes documents where the ``rating`` is greater than ``8``
-- Specifies the method to use the ``_id`` as the index
+- Matches and deletes documents where the ``length`` is greater than ``300``
+- Instructs the method to use the ``_id`` as the index
 
 .. io-code-block::
    :copyable: true
 
    .. input::
       :language: go
 
-      filter := bson.D{{"rating", bson.D{{"$gt", 8}}}}
+      filter := bson.D{{"length", bson.D{{"$gt", 300}}}}
       opts := options.Delete().SetHint(bson.D{{"_id", 1}})
 
       result, err := coll.DeleteMany(context.TODO(), filter, opts)
@@ -141,8 +150,9 @@ following guides:
 
 To learn about how the driver uses Context, see :ref:`golang-context`.
 
-.. To learn more about specifying hints, see <TODO: Indexes>.
-.. To learn more about collations, see  <TODO: Collations>.
+To learn more about specifying hints, see :ref:`golang-indexes`.
+
+To learn more about collations, see :ref:`golang-collations`.
 
 API Documentation
 ~~~~~~~~~~~~~~~~~