Add edge case notes

matrix-org · Oct 25, 2023 · 421c7a1 · 421c7a1
1 parent 3e3de91
commit 421c7a1
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/modules/add_extra_fields_to_client_events_unsigned.md b/docs/modules/add_extra_fields_to_client_events_unsigned.md
@@ -24,3 +24,9 @@ async def add_field_to_unsigned(
 
 where the extra fields to add to the event's unsigned section is returned.
 (Modules must not attempt to modify the `event` directly).
+
+This cannot be used to alter the "core" fields in the unsigned section emitted
+by Synapse itself.
+
+If multiple such callbacks try to add the same field to an event's unsigned
+section, the last-registered callback wins.