Apply suggestions from code review

matthew/matrix-uri
Kitsune Ral 4 years ago
parent 11d2529a5e
commit a32d7f5027

@ -220,7 +220,7 @@ of a given Matrix entity:
```text ```text
path = entity-descriptor ["/" entity-descriptor] path = entity-descriptor ["/" entity-descriptor]
entity-descriptor = nonid-segment / type-qualifier id-without-sigil entity-descriptor = nonid-segment / type-qualifier id-without-sigil
non-id-segment = segment-nz ; as defined in RFC 3986, see also below nonid-segment = segment-nz ; as defined in RFC 3986, see also below
type-qualifier = segment-nz "/" ; as defined in RFC 3986, see also below type-qualifier = segment-nz "/" ; as defined in RFC 3986, see also below
id-without-sigil = string ; as defined in Matrix identifier spec, see below id-without-sigil = string ; as defined in Matrix identifier spec, see below
``` ```
@ -310,10 +310,11 @@ it is not proposed here to generate or read the authority part of the URI.
Clients MAY introduce and recognise custom query items, according to Clients MAY introduce and recognise custom query items, according to
the following rules: the following rules:
- the name of the item MUST follow the reverse-DNS (aka "Java package") - the name of a custom item MUST follow the reverse-DNS (aka "Java package")
naming convention - e.g., a custom action item for Element clients would be naming convention, as per
named `io.element.action`, for Quaternion - `com.github.quaternion.action`, [MSC2758](https://github.com/matrix-org/matrix-doc/pull/2758) - e.g.,
etc. a custom action item for Element clients would be named `io.element.action`,
for Quaternion - `com.github.quaternion.action`, etc.
- the value of the item can be any content but its representation in the URI - the value of the item can be any content but its representation in the URI
MUST follow the general RFC requirements for the query part; on top of that, MUST follow the general RFC requirements for the query part; on top of that,
if the raw value contains `&` it MUST be percent-encoded. if the raw value contains `&` it MUST be percent-encoded.

Loading…
Cancel
Save