diff --git a/proposals/2312-matrix-uri.md b/proposals/2312-matrix-uri.md index fcc8a200..63e79921 100644 --- a/proposals/2312-matrix-uri.md +++ b/proposals/2312-matrix-uri.md @@ -37,13 +37,14 @@ To cover the use cases above, the following scheme is proposed for Matrix URIs ```text matrix:[//{authority}/]{type}/{id without sigil}[/{more type/id pairs}][?{query}] ``` -with `type` being one of: `user`, `room`, `roomid`, `event` and -`group`; and the only `query` defined for now is `action=join`. The Matrix -identifier (or identifiers) can be reconstructed from the URI by taking -the sigil that corresponds to `type` and appending `id without sigil` to it. -The query may alter the kind of request with respect to the Matrix resource; -and Matrix resources can be contained in each other, in which care the -`more type/id pairs` series is used to reconstruct inner identifiers. +with `type` defining the resource type (such as `user` or `roomid` - see +the "Path" section in the proposal) and `query` containing additional hints +or request details on the Matrix entity (see "Query" in the proposal). +The Matrix identifier (or identifiers) can be reconstructed from the URI by +taking the sigil that corresponds to `type` and appending `id without sigil` +to it. To support a hierarchy of Matrix resources, `more type/id pairs` series +is used to reconstruct inner identifiers (as of now, there can be only one +inner identifier, pointing to an event in a room). This proposal defines initial mapping of URIs to Matrix identifiers and actions on corresponding resources; the scheme and mapping are subject