DOCSP-26412 Update "Insert One" Usage Example w/ Document Structs (#193)

* first draft: edit code sample, page, and add ref tag to struct tag section

* fix capitalization

* fix typo in struct tags

* more typo fixes + sentence fixes

* move omit empty note

* address review comments

Author: ajhuh-mdb

source/fundamentals/bson.txt

@@ -49,6 +49,8 @@ than 100:
 To learn more about how the Go Driver handles BSON data, see the
 `bson package API documentation <{+api+}/bson>`__.
 
+.. _golang-struct-tags:
+
 Struct Tags
 -----------
 

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

@@ -7,11 +7,22 @@ import (
 	"os"
 
 	"github.com/joho/godotenv"
-	"go.mongodb.org/mongo-driver/bson"
 	"go.mongodb.org/mongo-driver/mongo"
 	"go.mongodb.org/mongo-driver/mongo/options"
 )
 
+// start-restaurant-struct
+type Restaurant struct {
+	Name         string
+	RestaurantId string `bson:"restaurant_id,omitempty"`
+	Cuisine      string
+	Address      interface{} `bson:"address,omitempty"`
+	Borough      string
+	Grades       []interface{} `bson:"grades,omitempty"`
+}
+
+// end-restaurant-struct
+
 func main() {
 	if err := godotenv.Load(); err != nil {
 		log.Println("No .env file found")
@@ -33,10 +44,10 @@ func main() {
 	}()
 
 	// begin insertOne
-	coll := client.Database("insertDB").Collection("haikus")
-	doc := bson.D{{"title", "Record of a Shriveled Datum"}, {"text", "No bytes, no problem. Just insert a document, in MongoDB"}}
+	coll := client.Database("sample_restaurants").Collection("restaurants")
+	newRestaurant := Restaurant{Name: "8282", Cuisine: "Korean", Borough: "Manhattan"}
 
-	result, err := coll.InsertOne(context.TODO(), doc)
+	result, err := coll.InsertOne(context.TODO(), newRestaurant)
 	if err != nil {
 		panic(err)
 	}

source/usage-examples/insertOne.txt

@@ -14,7 +14,22 @@ Example
 
 .. include:: /includes/usage-examples/run-example-tip.rst
 
-The following example inserts a document in the ``haikus`` collection:
+
+This example uses the following ``Restaurant`` struct as a model for documents
+in the ``restaurants`` collection:
+
+.. literalinclude:: /includes/usage-examples/code-snippets/insertOne.go
+   :start-after: start-restaurant-struct
+   :end-before: end-restaurant-struct
+   :language: go 
+   :copyable: 
+   :dedent:
+
+The ``omitempty`` :ref:`struct tag<golang-struct-tags>` omits the corresponding 
+field from the inserted document when left empty.
+
+
+The following example inserts a new document to the ``restaurants`` collection:
 
 .. include:: /includes/fundamentals/automatic-db-coll-creation.rst
 
@@ -31,18 +46,20 @@ Expected Result
 ---------------
 
 After you run the full example, you can find the following inserted
-document in the ``haikus`` collection:
+document in the ``restaurants`` collection:
 
 .. code-block:: json
    :copyable: false
 
    {
      "_id": ObjectId("..."),
-     "title": "Record of a Shriveled Datum",
-     "text": "No bytes, no problem. Inserting a document. In MongoDB"
+     "name": "8282",
+     "cuisine": "Korean",
+     "borough": "Manhattan"
    }
 
-For an example on how to find a document, see :ref:`golang-find-one`.
+For an example on how to find a document, see the :ref:`golang-find-one` usage 
+example.
 
 Additional Information
 ----------------------