Skip to content

Commit

Permalink
Remove group identifiers
Browse files Browse the repository at this point in the history
Groups are replaced by #1772 and this probably shouldn't have made it into the spec in the first place without the remaining context of Groups.
  • Loading branch information
turt2live authored and richvdh committed Aug 23, 2021
1 parent a2342f5 commit f5336ca
Showing 1 changed file with 10 additions and 27 deletions.
37 changes: 10 additions & 27 deletions content/appendices.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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.
Expand All @@ -690,6 +663,16 @@ versions](/#room-versions). These slashes should normally be
encoded when producing matrix.to URIs, however.
{{% /boxes/note %}}

{{% boxes/note %}}
<!-- TODO: @@TravisR: Make "Spaces" a link when that specification exists -->
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
Expand Down

0 comments on commit f5336ca

Please sign in to comment.