docs(NODE-6223): add documentation about auto-connect and CSOT

Author: nbbeeken

src/mongo_client.ts

@@ -510,6 +510,13 @@ export class MongoClient extends TypedEventEmitter<MongoClientEvents> implements
   /**
    * Connect to MongoDB using a url
    *
+   * @remarks
+   * Calling connect is optional as the first operation you preform will call connect if it's needed.
+   * `timeoutMS` specified at the client-level will bound the time any operation can take before throwing a timeout error.
+   * However, when the operation being run is automatically connecting your MongoClient the timeoutMS will only be used for the operation portion of task.
+   * This means the time to setup the MongoClient does not count against timeoutMS.
+   * If you are using timeoutMS we recommend connecting your client explicitly in advance of any operation to avoid this inconsistent execution time.
+   *
    * @see docs.mongodb.org/manual/reference/connection-string/
    */
   async connect(): Promise<this> {
@@ -713,6 +720,13 @@ export class MongoClient extends TypedEventEmitter<MongoClientEvents> implements
    * Connect to MongoDB using a url
    *
    * @remarks
+   * Calling connect is optional as the first operation you preform will call connect if it's needed.
+   * `timeoutMS` specified at the client-level will bound the time any operation can take before throwing a timeout error.
+   * However, when the operation being run is automatically connecting your MongoClient the timeoutMS will only be used for the operation portion of task.
+   * This means the time to setup the MongoClient does not count against timeoutMS.
+   * If you are using timeoutMS we recommend connecting your client explicitly in advance of any operation to avoid this inconsistent execution time.
+   *
+   * @remarks
    * The programmatically provided options take precedence over the URI options.
    *
    * @see https://www.mongodb.com/docs/manual/reference/connection-string/