No to multiple brokers for now 😢 (#1995)

---------
Co-authored-by: Finn Ellis <[email protected]>
Co-authored-by: Katie Horne <[email protected]>

Author: armchairlinguist

docs/semgrep-ci/network-broker.md

@@ -329,11 +329,11 @@ In broker `v0.31.0` and later, this URL is part of the default allowlist.
 
 ## Run multiple instances of the Semgrep Network Broker
 
-You can run multiple instances of the Semgrep Network Broker to manage availability. Semgrep handles multiple requests accordingly, preventing issues like duplicate PR or MR comments. 
+Do not attempt to run multiple instances of the Semgrep Network Broker to increase availability. Running multiple instances can result in contention and is less reliable than running a single instance.
 
-Each Semgrep deployment requires and accepts exactly one configuration file. If you run multiple instances of the Semgrep Network Broker, each instance associated with the same deployment must use the same configuration file.
+## Allowlist multiple source code managers with one configuration file
 
-You can allowlist multiple source code managers (SCM) within a single configuration file. One entry for a given SCM [uses the SCM-specific key provided in the configuration file](/semgrep-ci/network-broker#update-the-config-with-your-scm-information), as shown in the following example for a GitHub connection:
+It is possible to allow access to multiple source code managers (SCM) within a single configuration file. One entry for a given SCM [uses the SCM-specific key provided in the configuration file](/semgrep-ci/network-broker#update-the-config-with-your-scm-information), as shown in the following example for a GitHub connection:
 
 <pre class="language-console"><code>
 github:
@@ -363,5 +363,3 @@ allowlist:
 &nbsp;&nbsp;&nbsp;   Authorization: "Bearer <span className="placeholder">GITHUB_PAT</span>"
 &nbsp;...
 </code></pre>
-
-You may see some noise in your logs when using multiple Network Broker instances, since the Broker hasn't been architected yet for this specific configuration.