From 8b7187927df32e59478134b8713150d1a710c002 Mon Sep 17 00:00:00 2001 From: Kim Brose <2803622+HarHarLinks@users.noreply.github.com> Date: Wed, 4 Feb 2026 14:45:13 +0100 Subject: [PATCH] Add identifier pronunciation (#2307) * Add identifier pronunciation Signed-off-by: HarHarLinks <2803622+HarHarLinks@users.noreply.github.com> * Add changelog entry Signed-off-by: HarHarLinks <2803622+HarHarLinks@users.noreply.github.com> --------- Signed-off-by: HarHarLinks <2803622+HarHarLinks@users.noreply.github.com> --- changelogs/appendices/newsfragments/2307.clarification | 1 + content/appendices.md | 5 +++++ 2 files changed, 6 insertions(+) create mode 100644 changelogs/appendices/newsfragments/2307.clarification diff --git a/changelogs/appendices/newsfragments/2307.clarification b/changelogs/appendices/newsfragments/2307.clarification new file mode 100644 index 00000000..e81f3952 --- /dev/null +++ b/changelogs/appendices/newsfragments/2307.clarification @@ -0,0 +1 @@ +Add identifier pronunciation guidelines. Contributed by @HarHarLinks. diff --git a/content/appendices.md b/content/appendices.md index 52bb79fb..5f943df1 100644 --- a/content/appendices.md +++ b/content/appendices.md @@ -533,6 +533,11 @@ where `domain` is the [server name](#server-name) of the homeserver which allocated the identifier, and `localpart` is an identifier allocated by that homeserver. +Because the domain part identifies the server on which the ID resolves, +the canonical pronunciation of the separating `:` is "on". +For example, `@user:matrix.org` would be pronounced as "at user on matrix dot +org". + The precise grammar defining the allowable format of an identifier depends on the type of identifier. For example, event IDs can sometimes be represented with a `domain` component under some conditions - see the