Wording/grammar fixes from code review

Co-authored-by: Denis Kasak <dkasak@termina.org.uk>
matthew/matrix-uri
Kitsune Ral 4 years ago committed by GitHub
parent eeb5ce222c
commit c3329fe644
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -101,7 +101,7 @@ around MUST/SHOULD/MAY):
MUST NOT have Matrix URIs that are equal in MUST NOT have Matrix URIs that are equal in
[RFC 3986](https://tools.ietf.org/html/rfc3986) sense [RFC 3986](https://tools.ietf.org/html/rfc3986) sense
(but two distinct Matrix URIs MAY map to the same Matrix identifier). (but two distinct Matrix URIs MAY map to the same Matrix identifier).
1. The following classes MUST be supported: 1. References to the following entities MUST be supported:
1. User IDs (`@user:example.org`) 1. User IDs (`@user:example.org`)
1. Room IDs (`!roomid:example.org`) 1. Room IDs (`!roomid:example.org`)
1. Room aliases (`#roomalias:example.org`) 1. Room aliases (`#roomalias:example.org`)
@ -407,7 +407,7 @@ further discussion should happen in GitHub comments.
`//` if the URI doesn't have an authority component. In other words, `//` if the URI doesn't have an authority component. In other words,
`//` implies a centre of authority, and the (public) Matrix `//` implies a centre of authority, and the (public) Matrix
federation is not supposed to have one; hence no `//` in most URIs. federation is not supposed to have one; hence no `//` in most URIs.
1. _Why type specifiers use singular rather than plural 1. _Why do type specifiers use singular rather than plural
as is common in RESTful APIs?_ as is common in RESTful APIs?_
Unlike in actual RESTful APIs, this MSC does not see `rooms/` or Unlike in actual RESTful APIs, this MSC does not see `rooms/` or
`users/` as collections to browse. The type specifier completes `users/` as collections to browse. The type specifier completes
@ -428,7 +428,7 @@ further discussion should happen in GitHub comments.
further below, the current proposal provides enough space to define further below, the current proposal provides enough space to define
synonyms; this may need some canonicalisation service from homeservers synonyms; this may need some canonicalisation service from homeservers
so that we don't have to enable synonyms at each client individually. so that we don't have to enable synonyms at each client individually.
1. _Why event URI cannot use the fragment part for the event id?_ 1. _Why can an event URI not use the fragment part for the event ID?_
Because fragment is a part processed exclusively by the client Because fragment is a part processed exclusively by the client
in order to navigate within a larger document, and room cannot in order to navigate within a larger document, and room cannot
be considered a "document". Each event can be retrieved from the server be considered a "document". Each event can be retrieved from the server

Loading…
Cancel
Save