wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Remove straggling case of "groups" (#3652)

Browse source 
* Remove straggling case of "groups"

* changelog
This commit is contained in:
Travis Ralston 2022-01-18 08:58:58 -07:00 • committed by GitHub
parent fc3f7d60eb
commit 3475ef62ab
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 14 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/3652.clarification Normal file
View file

@ -0,0 +1 @@
Clarify that group mentions are no longer in the specification.

21
content/client-server-api/modules/mentions.md
View file

@ -2,12 +2,11 @@
type: module
---
### User, room, and group mentions
### User and room mentions
This module allows users to mention other users, rooms, and groups
within a room message. This is achieved by including a [matrix.to
URI](/appendices/#matrixto-navigation) in the HTML body of an
[m.room.message](#mroommessage) event. This module does not have any server-specific
This module allows users to mention other users and rooms within a room message.
This is achieved by including a [Matrix URI](/appendices/#uris) in the HTML body of
an [m.room.message](#mroommessage) event. This module does not have any server-specific
behaviour to it.
Mentions apply only to [m.room.message](#mroommessage) events where the `msgtype` is
@ -28,7 +27,7 @@ To make a mention, reference the entity being mentioned in the
#### Client behaviour
In addition to using the appropriate `matrix.to URI` for the mention,
In addition to using the appropriate `Matrix URI` for the mention,
clients should use the following guidelines when making mentions in
events to be sent:
@ -40,7 +39,6 @@ events to be sent:
listed on the room. If no alias can be found, fall back to the room
ID. In all cases, use the alias/room ID being linked to as the
anchor's text.
- When referencing groups, use the group ID as the anchor's text.
The text component of the anchor should be used in the event's `body`
where the mention would normally be represented, as shown in the example
@ -56,4 +54,11 @@ mention differently from other mentions, such as by using a red
background color to signify to the user that they were mentioned.
When clicked, the mention should navigate the user to the appropriate
room, group, or user information.
user or room information.
{{% boxes/note %}}
Similar to legacy [matrix.to URLs](/appendices/#matrixto-navigation),
groups used to be representable by mentions. They follow a similar format
to room mentions, though using the group ID in both the link and anchor
text.
{{% /boxes/note %}}