DOCSP-52911 Break up FAQ (#13692)

* DOCSP-52911 Break up FAQ

* edits

* SA review

* code edit

Author: lindseymoore

content/golang/upcoming/source/connect/connection-options/connection-pools.txt

@@ -54,6 +54,10 @@ For efficiency, create a client once for each process, and reuse it for all
 operations. Avoid creating a new client for each request because this will
 increase latency.
 
+If sockets close due to any network errors, causing the total number of sockets
+(both in use and idle) to drop below the minimum, more sockets open until the 
+minimum is reached.
+
 Configure a Connection Pool
 ---------------------------
 
@@ -89,7 +93,8 @@ see the corresponding syntax:
 
         * - ``minPoolSize``
 
-          - Minimum number of connections opened in the pool. The value of
+          - Minimum number of connections opened in the pool. The connection pool is 
+            initialized with this number of sockets. The value of
             ``minPoolSize`` must be less than the value of ``maxPoolSize``.
 
             *Default*: ``0``
@@ -110,7 +115,8 @@ see the corresponding syntax:
         * - ``waitQueueTimeoutMS```
 
           - Specifies the maximum wait time in milliseconds that a thread can wait
-            for a connection to become available.
+            for a connection to become available. An operation that waits for a socket 
+            longer than this defined length of time raises a connection error.
 
             *Default*: ``0`` (no limit)
 

content/golang/upcoming/source/data-formats/bson.txt

@@ -313,7 +313,10 @@ The ``Cursor`` type also uses the ``All()`` method, which unmarshals all
 documents stored in the cursor into an array at the same time.
 
 The ``bson`` package includes a family of ``Marshal()`` and ``Unmarshal()``
-methods that work with BSON-encoded data of ``[]byte`` type.
+methods that work with BSON-encoded data of ``[]byte`` type. The ``bson.Marshal()`` and 
+``bson.Unmarshal()`` methods require a parameter that can be encoded into a BSON document, 
+such as a ``bson.D`` type. A ``Write`` error occurs if you pass an incorrect type. 
+For example, if you pass a string to ``bson.Marshal()``, a ``WriteString`` error occurs.
 
 The following code demonstrates how you can unmarshal BSON back into a
 user-defined struct by using methods from the ``bson`` package:

content/golang/upcoming/source/data-formats/extended-json.txt

@@ -171,26 +171,53 @@ Write Extended JSON
 -------------------
 
 You can produce an Extended JSON string from an instance of a
-{+language+} struct by calling the ``bson.MarshalExtJSON()`` method. 
+{+language+} struct or BSON document by calling the ``bson.MarshalExtJSON()`` method. 
 The following example creates an Extended JSON string in the Relaxed
-format from an instance of ``Person``:
+format from either a struct or BSON document. Select the :guilabel:`Struct` or 
+:guilabel:`bson.D` tab to see the corresponding example:
 
-.. io-code-block::
-   :copyable: true
+.. tabs::
 
-   .. input:: /includes/data-formats/ejson.go
-      :start-after: begin-marshal
-      :end-before: end-marshal
-      :language: go
-      :emphasize-lines: 10
-      :dedent:
+   .. tab:: Struct
+      :tabid: struct
 
-   .. output::
-      :language: none
-      :visible: false
+      .. io-code-block::
+         :copyable: true
+
+         .. input:: /includes/data-formats/ejson.go
+            :start-after: begin-marshal
+            :end-before: end-marshal
+            :language: go
+            :emphasize-lines: 10
+            :dedent:
+
+         .. output::
+            :language: none
+            :visible: false
+
+            Extended JSON Representation:
+            {"_id":{"$oid":"686688fa7c1a2e75405f4697"},"name":"Matteo Carisi","age":49,"birthday":{"$date":"1975-10-30T00:00:00Z"},"address":{"street":"14a Corner Court","city":"Springfield","state":"IL"},"hobbies":["cooking","birdwatching"]}
+
+   .. tab:: bson.D
+      :tabid: bson.D
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input:: /includes/data-formats/ejson.go
+            :start-after: begin-marshal-bson-v
+            :end-before: end-marshal-bson-v
+            :language: go
+            :emphasize-lines: 3
+            :dedent:
+
+         .. output::
+            :language: none
+            :visible: false
+
+            Extended JSON Representation:
+            {"hello":"world","number":1}
 
-      Extended JSON Representation:
-      {"_id":{"$oid":"686688fa7c1a2e75405f4697"},"name":"Matteo Carisi","age":49,"birthday":{"$date":"1975-10-30T00:00:00Z"},"address":{"street":"14a Corner Court","city":"Springfield","state":"IL"},"hobbies":["cooking","birdwatching"]}
 
 The second parameter to ``MarshalExtJSON()`` determines if the output
 string is in Canonical (Extended) format or Relaxed format. The

content/golang/upcoming/source/includes/data-formats/ejson.go

@@ -50,12 +50,12 @@ func main() {
 		Hobbies:  []string{"cooking", "birdwatching"},
 	}
 
-	newExtJsonString, err := bson.MarshalExtJSON(person, false, true)
+	newExtJsonStringFromStruct, err := bson.MarshalExtJSON(person, false, true)
 	if err != nil {
 		log.Fatal(err)
 	}
 
-	fmt.Printf("Extended JSON Representation:\n%s\n", newExtJsonString)
+	fmt.Printf("Extended JSON Representation:\n%s\n", newExtJsonStringFromStruct)
 	// end-marshal
 
 	// begin-marshal-fmt
@@ -67,4 +67,14 @@ func main() {
 	fmt.Printf("%s\n", formattedString)
 	// end-marshal-fmt
 
+	// begin-marshal-bson-v
+	bsonDocument := bson.D{{"hello", "world"}, {"number", 1}}
+
+	newExtJsonStringFromBson, err := bson.MarshalExtJSON(bsonDocument, false, true)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Printf("Extended JSON Representation:\n%s\n", newExtJsonStringFromBson)
+	// end-marshal-bson-v
 }

content/golang/upcoming/source/reference.txt

@@ -12,5 +12,4 @@ Reference
    Compatibility </reference/compatibility>
    Upgrade Guides </reference/upgrade>
    Quick Reference </reference/quick-reference>
-   FAQ </reference/faq>