Skip to content

Commit 246a97e

Browse files
committed
Add clarification as per review
1 parent eca9993 commit 246a97e

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

proposals/2312-matrix-uri.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -302,6 +302,21 @@ confirmation or at least notify the user before joining or creating a new room.
302302
Conversely, no additional confirmation/notification is necessary when
303303
the action leads to opening a room the user is already a member of.
304304

305+
It is worth reiterating on the (blurry) distinction between URIs with `action`
306+
and those without:
307+
- a URI with no `action` simply _identifies_ the resource; if the context
308+
implies an operation, it is usually focused on the retrieval of the resource,
309+
in line with RFC 3986 (see also the next paragraph);
310+
- a URI with `action` in the query means that a client application should (but
311+
is not obliged to) perform that action, with precautions as described above.
312+
313+
In some cases a client application may have no meaningful way to immediately
314+
perform the default operation suggested by this MSC (see below); e.g.,
315+
the client may be unable to display a room before joining it, while the URI
316+
doesn't have `action=join`. In these cases client applications are free to do
317+
what's best for user experience (e.g., suggest joining the room), even if that
318+
means performing an action on a URI with no `action` in the query.
319+
305320
The routing query (`via=`) indicates servers that are likely involved in
306321
the room (see also
307322
[the feature of matrix.to](https://matrix.org/docs/spec/appendices#routing)).

0 commit comments

Comments
 (0)