Clarify what matrix.to is and mention that room IDs are not routable

Also actually render the warning saying that this scheme is temporary.
pull/977/head
Travis Ralston 6 years ago
parent fa3e9a7609
commit 39e674ccb3

@ -287,8 +287,10 @@ domain).
matrix.to navigation matrix.to navigation
++++++++++++++++++++ ++++++++++++++++++++
.. NOTE: .. NOTE::
This namespacing is in place pending a ``matrix://`` (or similar) URI scheme. This namespacing is in place pending a ``matrix://`` (or similar) URI scheme.
This is **not** meant to be interpreted as an available web service - see
below for more details.
Rooms, users, aliases, and groups may be represented as a "matrix.to" URI. Rooms, users, aliases, and groups may be represented as a "matrix.to" URI.
This URI can be used to reference particular objects in a given context, such This URI can be used to reference particular objects in a given context, such
@ -307,14 +309,19 @@ followed by the identifier.
Clients should not rely on matrix.to URIs falling back to a web server if accessed Clients should not rely on matrix.to URIs falling back to a web server if accessed
and instead should perform some sort of action within the client. For example, if and instead should perform some sort of action within the client. For example, if
the user where to click on a matrix.to URI for a room alias, the client may open the user were to click on a matrix.to URI for a room alias, the client may open
a view for the user to participate in the room. a view for the user to participate in the room.
Examples of matrix.to URIs are: Examples of matrix.to URIs are:
* Room: ``https://matrix.to/#/!somewhere:domain.com``
* Room alias: ``https://matrix.to/#/#somewhere:domain.com`` * Room alias: ``https://matrix.to/#/#somewhere:domain.com``
* Room: ``https://matrix.to/#/!somewhere:domain.com``
* Permalink by room: ``https://matrix.to/#/!somewhere:domain.com/$event:example.org`` * Permalink by room: ``https://matrix.to/#/!somewhere:domain.com/$event:example.org``
* Permalink by room alias: ``https://matrix.to/#/#somewhere:domain.com/$event:example.org`` * Permalink by room alias: ``https://matrix.to/#/#somewhere:domain.com/$event:example.org``
* User: ``https://matrix.to/#/@alice:example.org`` * User: ``https://matrix.to/#/@alice:example.org``
* Group: ``https://matrix.to/#/+example:domain.com`` * Group: ``https://matrix.to/#/+example:domain.com``
.. Note::
Room ID permalinks are unroutable as there is no reliable domain to send requests
to upon receipt of the permalink. Clients should do their best route Room IDs to
where they need to go, however they should also be aware of `issue #1579 <https://github.com/matrix-org/matrix-doc/issues/1579>`_.
Loading…
Cancel
Save