From 3c01fa4681f29944bbbba2a7f352e61e001c0661 Mon Sep 17 00:00:00 2001 From: Travis Ralston Date: Tue, 4 May 2021 09:43:02 -0600 Subject: [PATCH] Remove group identifiers Groups are replaced by https://github.com/matrix-org/matrix-doc/pull/1772 and this probably shouldn't have made it into the spec in the first place without the remaining context of Groups. --- content/appendices.md | 37 ++++++++++--------------------------- 1 file changed, 10 insertions(+), 27 deletions(-) diff --git a/content/appendices.md b/content/appendices.md index 9132dd6d..aa19aeae 100644 --- a/content/appendices.md +++ b/content/appendices.md @@ -590,32 +590,6 @@ Event IDs and Room IDs are case-sensitive. They are not meant to be human-readable. They are intended to be treated as fully opaque strings by clients. -#### Group Identifiers - -Groups within Matrix are uniquely identified by their group ID. The -group ID is namespaced to the group server which hosts this group and -has the form: - - +localpart:domain - -The `localpart` of a group ID is an opaque identifier for that group. It -MUST NOT be empty, and MUST contain only the characters `a-z`, `0-9`, -`.`, `_`, `=`, `-`, and `/`. - -The `domain` of a group ID is the [server name](#server-name) of the -group server which hosts this group. - -The length of a group ID, including the `+` sigil and the domain, MUST -NOT exceed 255 characters. - -The complete grammar for a legal group ID is: - - group_id = "+" group_id_localpart ":" server_name - group_id_localpart = 1*group_id_char - group_id_char = DIGIT - / %x61-7A ; a-z - / "-" / "." / "=" / "_" / "/" - #### Room Aliases A room may have zero or more aliases. A room alias has the format: @@ -674,7 +648,6 @@ Examples of matrix.to URIs are: - Permalink by room alias: `https://matrix.to/#/%23somewhere:example.org/%24event%3Aexample.org` - User: `https://matrix.to/#/%40alice%3Aexample.org` -- Group: `https://matrix.to/#/%2Bexample%3Aexample.org` {{% boxes/note %}} Historically, clients have not produced URIs which are fully encoded. @@ -690,6 +663,16 @@ versions](/#room-versions). These slashes should normally be encoded when producing matrix.to URIs, however. {{% /boxes/note %}} +{{% boxes/note %}} + +In prior versions of this specification, a concept of "groups" were mentioned +to organize rooms. This functionality did not properly get introduced into +the specification and is subsequently replaced with "Spaces". Historical +matrix.to URIs pointing to groups might still exist: they take the form +`https://matrix.to/#/%2Bexample%3Aexample.org` (where the `+` sigil may or +may not be encoded). +{{% /boxes/note %}} + ##### Routing Room IDs are not routable on their own as there is no reliable domain to