Skip to content

Commit 9b2918e

Browse files
authored
Attempt to clarify what servers should not enforce about key naming
1 parent 1b98d40 commit 9b2918e

File tree

1 file changed

+7
-9
lines changed

1 file changed

+7
-9
lines changed

proposals/4133-extended-profiles.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -162,18 +162,16 @@ Profiles MUST be at most 64 KiB (65,536 bytes) in size, as measured in
162162
[Canonical JSON](https://spec.matrix.org/v1.13/appendices/#canonical-json), including the
163163
`avatar_url` and `displayname` fields.
164164

165-
Homeservers SHOULD NOT enforce namespaces, as future expansions may be unknown to the server, but
166-
clients SHOULD use the correct namespace when creating or updating fields.
165+
Keys MUST follow the [Common Namespaced Identifier Grammar](https://spec.matrix.org/v1.13/appendices/#common-namespaced-identifier-grammar), with the following considerations:
167166

168-
Keys MUST follow the [Common Namespaced Identifier Grammar](https://spec.matrix.org/v1.13/appendices/#common-namespaced-identifier-grammar),
169-
with the following considerations:
170-
171-
- **Namespace `m.*`**: Reserved for fields explicitly defined in the Matrix specification. Clients
172-
that do not recognise a field in this namespace MAY attempt to display it but SHOULD NOT attempt
173-
to update the content unless they understand its formatting and validation requirements.
167+
- **Namespace `m.*`**: Reserved for fields explicitly defined in the Matrix specification:
168+
- Servers SHOULD NOT check whether a key is known to be in the Matrix specification, as future expansions
169+
may be unknown to it.
170+
- Clients that do not recognise a field in this namespace MAY attempt to display it but SHOULD NOT
171+
attempt to update the content unless they understand its formatting and validation requirements.
174172

175173
- **Namespace `tld.name.*`**: For client-specific or unstable fields, using Java package naming
176-
convention (e.g., `com.example.custom_field`).
174+
convention (e.g. `com.example.custom_field`).
177175

178176
Following this change, clients could use `m.example_field` if that field is defined by the Matrix
179177
specification, or `org.example.job_title` for organisation, client-specific fields, or MSC-backed

0 commit comments

Comments
 (0)