wip

Author: mongoKart

source/connect/connection-options.txt

@@ -144,6 +144,66 @@ Server Selection
        | **MongoClient Example**: ``server_selector = your_function``
        | **Connection URI Example**: N/A
 
+Connection Pools
+~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :widths: 30 70
+   :header-rows: 1
+
+   * - Setting
+     - Description
+
+   * - ``connectTimeoutMS``
+     - | Sets the time that {+driver-short+} waits when connecting a new
+         socket before timing out.
+       | Defaults to ``20000``
+
+   * - ``maxConnecting``
+     - | Sets the maximum number of connections that each pool can establish concurrently.
+         If this limit is reached, further requests wait until a connection is established
+         or another in-use connection is checked back into the pool.
+       | Defaults to ``2``
+
+   * - ``maxIdleTimeMS``
+     - | Sets the maximum time that a connection can remain idle in the pool.
+       | Defaults to ``None`` (no limit)
+
+   * - ``maxPoolSize``
+     - | Sets the maximum number of concurrent connections that the pool maintains.
+         If the maximum pool size is reached, further requests wait until a connection
+         becomes available.
+       | Defaults to ``100``
+
+   * - ``minPoolSize``
+     - | Sets the minimum number of concurrent connections that the pool maintains. If
+         the number of open connections falls below this value due to network errors,
+         {+driver-short+} attempts to create new connections to maintain this minimum.
+       | Defaults to ``0``
+
+   * - ``socketTimeoutMS``
+     - | Sets the length of time that {+driver-short+} waits for a response from the server
+         before timing out.
+       | Defaults to ``None`` (no timeout)
+
+   * - ``waitQueueTimeoutMS``
+     - | Sets how long a thread waits for a connection to become available in the connection pool
+         before timing out.
+       | Defaults to ``None`` (no timeout)
+
+The following code creates a client with a maximum connection pool size of ``50`` by using the
+``maxPoolSize`` parameter:
+
+.. code-block:: python
+
+   client = MongoClient(host, port, maxPoolSize=50)
+
+The following code creates a client with the same configuration as the preceding example,
+but uses a connection URI:
+
+.. code-block:: python
+
+   client = MongoClient("mongodb://<host>:<port>/?maxPoolSize=50")
 Authentication
 ~~~~~~~~~~~~~~
 

source/index.txt

@@ -12,30 +12,31 @@ MongoDB {+driver-short+} Documentation
 
 .. toctree::
 
-   Get Started </get-started>
+   Getting Started </get-started>
    Connect </connect>
+   CRUD Operations
+   Data Formats </data-formats>
+   Indexes </indexes>
+   Run a Database Command </run-command>
+   Logging </logging> Monitoring </monitoring>
+   Security </security>
+   Versioning
+   API Documentation <{+api-root+}>
+   Issues & Help </issues-and-help>
+   
    Databases & Collections </databases-collections>
    Write Data </write-operations>
    Read Data </read>
-   Run a Database Command </run-command>
-   Indexes </indexes>
    Aggregation </aggregation>
-   Security </security>
-   Data Formats </data-formats>
-   Logging </logging>
-   Monitoring </monitoring>
    Serialization </serialization>
    Third-Party Tools </tools>
-   FAQ </faq>
    Troubleshooting </troubleshooting>
    What's New </whats-new>
    Upgrade </upgrade>
    Migrate from Motor </motor-async-migration>
    Switch to PyMongo Async </pymongo-to-async-guide>
    Previous Versions </previous-versions>
-   Issues & Help </issues-and-help>
    Compatibility </compatibility>
-   API Documentation <{+api-root+}>
 
 Overview
 --------