DOCSP-26194: CSOT (#202)

* DOCSP-26194: CSOT

* AH PR fixes 1

* content placement

Author: rustagir

source/fundamentals/connection.txt

@@ -143,6 +143,13 @@ URI to specify the behavior of the client.
      - Default Value
      - Description
 
+   * - **timeoutMS**
+     - integer
+     - ``null``
+     - Specifies the number of milliseconds that a single operation run on the
+       ``Client`` can take before returning a timeout error. Operations honor
+       this setting only if there is no deadline on the operation Context.
+
    * - **connectTimeoutMS**
      - integer
      - ``30000``
@@ -219,3 +226,47 @@ URI to specify the behavior of the client.
 For a full list of connection options, see the `ClientOptions API
 documentation
 <{+api+}/mongo/options#ClientOptions>`__.
+
+.. _golang-timeout-setting:
+
+Single Timeout Setting
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can set a single ``Timeout`` option on your ``Client`` to govern the
+amount of time that a single operation can take to execute using the
+``SetTimeout()`` method or specifying the ``timeoutMS`` option in your
+connection URI string. ``Database``, ``Collection``,
+``Session``, ``ChangeStream``, and ``Bucket`` instances elsewhere in
+your code inherit the ``Timeout`` option from ``Client`` if you do not set a
+Context for operations against the same entity. 
+
+If you pass a Context into an operation with a deadline, the driver uses
+that Context deadline for the operation. If the context does not have a
+deadline, the driver derives a new Context from the given Context using
+the ``Timeout`` option set on the ``Client``.
+
+The following code shows how to set the ``Timeout`` option on a ``Client``
+with the ``SetTimeout`` option:
+
+.. code-block:: go
+
+   opts := options.Client().SetTimeout(5 * time.Second)
+
+The following example shows how you can set a single timeout with the
+URI option and execute an operation that inherits this setting:
+
+.. code-block:: go
+
+   uri := "mongodb://user:[email protected]:27017/?timeoutMS=5000"
+   client := mongo.Connect(uri)
+   coll := client.Database("<db>").Collection("<collection>")
+   ...
+   coll.InsertOne(context.Background(), doc)
+
+.. important:: Legacy Timeout Options
+
+   ``SocketTimeout``, ``wTimeout``, ``MaxTime``, and ``MaxCommitTime``
+   will be deprecated in an upcoming release. The driver ignores ``MaxTime`` and
+   ``MaxCommitTime`` if you set ``Timeout``. The driver still honors
+   ``SocketTimeout`` and ``wTimeout``, but these settings may result in
+   undefined behavior. Consider using only the single timeout option instead.

source/fundamentals/context.txt

@@ -35,6 +35,11 @@ an error.
     ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
     defer cancel()
     client.Database("<db>").Collection("<collection>").Insert(ctx, bson.D{{"x",1}})
+    
+If the Context passed into an operation does not have a deadline, you
+can set a ``Timeout`` option on your ``Client`` and the operation will
+derive the timeout specification from this setting. To learn more
+about using the single timeout setting, see the :ref:`Connection Guide <golang-timeout-setting>`.
 
 Expiration
 ----------