Attempt to clarify what servers should not enforce about key naming

pull/4133/head
Tom Foster 11 months ago committed by GitHub
parent 1b98d40c1e
commit 9b2918e373
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

@ -162,18 +162,16 @@ Profiles MUST be at most 64 KiB (65,536 bytes) in size, as measured in
[Canonical JSON](https://spec.matrix.org/v1.13/appendices/#canonical-json), including the [Canonical JSON](https://spec.matrix.org/v1.13/appendices/#canonical-json), including the
`avatar_url` and `displayname` fields. `avatar_url` and `displayname` fields.
Homeservers SHOULD NOT enforce namespaces, as future expansions may be unknown to the server, but Keys MUST follow the [Common Namespaced Identifier Grammar](https://spec.matrix.org/v1.13/appendices/#common-namespaced-identifier-grammar), with the following considerations:
clients SHOULD use the correct namespace when creating or updating fields.
Keys MUST follow the [Common Namespaced Identifier Grammar](https://spec.matrix.org/v1.13/appendices/#common-namespaced-identifier-grammar), - **Namespace `m.*`**: Reserved for fields explicitly defined in the Matrix specification:
with the following considerations: - Servers SHOULD NOT check whether a key is known to be in the Matrix specification, as future expansions
may be unknown to it.
- **Namespace `m.*`**: Reserved for fields explicitly defined in the Matrix specification. Clients - Clients that do not recognise a field in this namespace MAY attempt to display it but SHOULD NOT
that do not recognise a field in this namespace MAY attempt to display it but SHOULD NOT attempt attempt to update the content unless they understand its formatting and validation requirements.
to update the content unless they understand its formatting and validation requirements.
- **Namespace `tld.name.*`**: For client-specific or unstable fields, using Java package naming - **Namespace `tld.name.*`**: For client-specific or unstable fields, using Java package naming
convention (e.g., `com.example.custom_field`). convention (e.g. `com.example.custom_field`).
Following this change, clients could use `m.example_field` if that field is defined by the Matrix Following this change, clients could use `m.example_field` if that field is defined by the Matrix
specification, or `org.example.job_title` for organisation, client-specific fields, or MSC-backed specification, or `org.example.job_title` for organisation, client-specific fields, or MSC-backed

Loading…
Cancel
Save