Merge pull request #1289 from matrix-org/t3chguy/group_id

basic spec for group IDs, mostly copied from User IDs as they share grammar
pull/1449/head
Michael Telatynski 6 years ago committed by GitHub
commit 2790c1f069
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -60,6 +60,7 @@ The sigil characters are as follows:
* ``@``: User ID * ``@``: User ID
* ``!``: Room ID * ``!``: Room ID
* ``$``: Event ID * ``$``: Event ID
* ``+``: Group ID
* ``#``: Room alias * ``#``: Room alias
The precise grammar defining the allowable format of an identifier depends on The precise grammar defining the allowable format of an identifier depends on
@ -207,6 +208,35 @@ readable.
.. TODO-spec .. TODO-spec
What is the grammar for the opaque part? https://matrix.org/jira/browse/SPEC-389 What is the grammar for the opaque part? https://matrix.org/jira/browse/SPEC-389
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`_ 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 Room Aliases
++++++++++++ ++++++++++++

Loading…
Cancel
Save