Update docs for max_worker_queue_len

Author: chrzaszcz

doc/configuration/outgoing-connections.md

@@ -57,6 +57,17 @@ Number of workers to be started by the pool.
 
 Number of milliseconds after which a call to the pool will time out.
 
+### `outgoing_pools.*.*.max_worker_queue_len`
+* **Syntax:** non-negative integer
+* **Default:** not set
+* **Example:** `max_worker_queue_len = 1000`
+
+Maximum number of requests waiting in the incoming message queue of a worker. By default there is no such limit.
+When this queue length is reached for all workers, further incoming requests will be dropped.
+
+!!! Note
+    This option is applicable only to the `best_worker` strategy. Using it for other strategies is not allowed.
+
 ## Connection options
 
 Options specific to a pool connection are defined in a subsection starting with `[outgoing_pools.*.*.connection]`.
@@ -338,13 +349,6 @@ Sets the RabbitMQ Virtual Host. The host needs to exist, as it is **not** create
 
 Enables/disables one-to-one publishers confirms.
 
-### `outgoing_pools.rabbit.*.connection.max_worker_queue_len`
-* **Syntax:** non-negative integer or `"infinity"`
-* **Default:** `1000`
-* **Example:** `max_worker_queue_len = "infinity"`
-
-Sets a limit of messages in a worker's mailbox above which the worker starts dropping the messages. If a worker message queue length reaches the limit, messages from the head of the queue are dropped until the queue length is again below the limit. Use `infinity` to disable.
-
 ---
 To enable TLS, you need to include the [TLS section](#tls-options) in the connection options.
 

doc/migrations/6.5.0_6.x.x.md

@@ -0,0 +1,7 @@
+## Configuration options
+
+### RabbitMQ connection pool
+
+The RabbitMQ-specific connection option `max_worker_queue_len` is now replaced with a more generic [worker pool option](../configuration/outgoing-connections.md#outgoing_poolsmax_worker_queue_len) with the same name.
+Contrary to the removed option, it now ensures that the queue limit is never exceeded.
+Make sure you use the new option instead of the removed one.

mkdocs.yml

@@ -219,6 +219,7 @@ nav:
       - '6.3.1 to 6.3.2': 'migrations/6.3.1_6.3.2.md'
       - '6.3.3 to 6.4.0': 'migrations/6.3.3_6.4.0.md'
       - '6.4.0 to 6.5.0': 'migrations/6.4.0_6.5.0.md'
+      - '6.5.0 to 6.x.x': 'migrations/6.5.0_6.x.x.md'
       - 'MAM MUC migration helper': 'migrations/jid-from-mam-muc-script.md'
   - 'Contributions to the Ecosystem': 'Contributions.md'
   - 'MongooseIM History': 'History.md'