Documenting rc_invites.per_issuer, resolves #13330.

Signed-off-by: David Teller <davidt@element.io>
matrix-org · Jul 20, 2022 · 90eac43 · 90eac43
1 parent 172ce29
commit 90eac43
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 0 deletions.
diff --git a/changelog.d/13330.doc b/changelog.d/13330.doc
@@ -0,0 +1 @@
+Documenting the new `rc_invites.per_issuer` throttling option.
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md
@@ -1528,6 +1528,8 @@ The `rc_invites.per_user` limit applies to the *receiver* of the invite, rather
 sender, meaning that a `rc_invite.per_user.burst_count` of 5 mandates that a single user
 cannot *receive* more than a burst of 5 invites at a time.
 
+By opposition, the `rc_invites.per_issuer` limit applies to the *issuer* of the invite, meaning that a `rc_invite.per_issuer.burst_count` of 5 mandates that single user cannot *send* more than a burst of 5 invites at a time.
+
 Example configuration:
 ```yaml
 rc_invites:
@@ -1537,6 +1539,9 @@ rc_invites:
  per_user:
  per_second: 0.004
  burst_count: 3
+ per_issuer:
+ per_second: 0.5
+ burst_count: 5
 ```
 ---
 ### `rc_third_party_invite`