From 2a342bcbc90dfde3225284e69c106bf63cb28692 Mon Sep 17 00:00:00 2001
From: Ginger <ginger@gingershaped.computer>
Date: Thu, 9 Jul 2026 13:15:45 -0400
Subject: [PATCH] fix: Move manual delegation warning

---
 docs/guides/delegation.mdx | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/docs/guides/delegation.mdx b/docs/guides/delegation.mdx
index 0a5c28928..d08822041 100644
--- a/docs/guides/delegation.mdx
+++ b/docs/guides/delegation.mdx
@@ -58,13 +58,6 @@ # Defaults to members of the admin room if unset
 
 To enable full discovery, you will need to reverse proxy these paths from the base domain back to Continuwuity.
 
-:::warning
-If you choose to serve the well-known files directly through your reverse proxy, and you are
-using delegation, you must still set the `global.well_known.client` configuration option to
-the domain you're delegating to. Continuwuity needs to know the domain it runs on for OAuth-compatible
-clients to work correctly.
-:::
-
 ## Reverse proxying well-known files to Continuwuity
 
 <details>
@@ -131,7 +124,11 @@ ## Reverse proxying well-known files to Continuwuity
 
 ### Serving well-known files manually
 
-Instead of configuring `[global.well_known]` options and reverse proxying well-known URIs, you can serve these files directly as static JSON that match the ones above. This is useful if your base domain points to a different physical server, and reverse proxying isn't feasible.
+Instead of reverse proxying well-known URIs, you can serve these files directly as static JSON that match the ones above. This is useful if your base domain points to a different physical server, and reverse proxying isn't feasible.
+
+:::warning
+Even if you choose to serve the well-known files manually, if you are using delegation at all, you **must** still set the `global.well_known.client` configuration option to the domain you're delegating to. Continuwuity needs to know the domain it runs on for OAuth-compatible clients to work correctly.
+:::
 
 <details>
 
@@ -159,6 +156,17 @@ ### Serving well-known files manually
 
 </details>
 
+<details>
+
+<summary>Accompanying Continuwuity configuration</summary>
+
+```toml
+[global.well_known]
+client = "https://matrix.example.com/"
+```
+
+</details>
+
 Remember to set the `Access-Control-Allow-Origin: *` header in your `/.well-known/matrix/client` path for web clients to work.
 
 ## Troubleshooting