Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify rules for escaping shapes bound to URIs #1630

Merged
merged 1 commit into from
Feb 24, 2023
Merged

Clarify rules for escaping shapes bound to URIs #1630

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions docs/source-1.0/spec/core/http-traits.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -682,8 +682,9 @@ structure with the ``httpLabel`` trait MUST have a corresponding
(for example, ``1985-04-12T23:20:50.52Z``, and with percent-encoding,
``1985-04-12T23%3A20%3A50.52Z``). The :ref:`timestampFormat-trait`
MAY be used to use a custom serialization format.
- Reserved characters defined in :rfc:`section 2.2 of RFC3986 <3986#section-2.2>`
and the `%` itself MUST be percent-encoded_ (that is, ``:/?#[]@!$&'()*+,;=%``).
- Characters not defined as unreserved by :rfc:`RFC 3986 section 2.3 <3986#section-2.3>`
MUST be :rfc:`percent-encoded <3986#section-2.1>`. That is, all characters except for
alphanumerics and ``-._~``.
- However, if the label is greedy, then "/" MUST NOT be percent-encoded
because greedy labels are meant to span multiple path segments.

Expand Down Expand Up @@ -918,8 +919,9 @@ request:

* "&" is used to separate query string parameter key-value pairs.
* "=" is used to separate query string parameter names from values.
* Reserved characters in keys and values as defined in :rfc:`section 2.2 of RFC3986 <3986#section-2.2>` and `%`
MUST be percent-encoded_ (that is, ``:/?#[]@!$&'()*+,;=%``).
* Characters not defined as unreserved by :rfc:`RFC 3986 section 2.3 <3986#section-2.3>`
MUST be :rfc:`percent-encoded <3986#section-2.1>`. That is, all characters except for
alphanumerics and ``-._~``.
* ``boolean`` values are serialized as ``true`` or ``false``.
* ``timestamp`` values are serialized as an :rfc:`3339`
``date-time`` string by default (for example, ``1985-04-12T23:20:50.52Z``,
Expand Down
13 changes: 6 additions & 7 deletions docs/source-2.0/spec/http-bindings.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -684,9 +684,9 @@ structure with the ``httpLabel`` trait MUST have a corresponding
(for example, ``1985-04-12T23:20:50.52Z``, and with percent-encoding,
``1985-04-12T23%3A20%3A50.52Z``). The :ref:`timestampFormat-trait`
MAY be used to use a custom serialization format.
- Reserved characters defined in :rfc:`section 2.2 of RFC3986 <3986#section-2.2>`
and the `%` itself MUST be :rfc:`percent-encoded <3986#section-2.1>` (that is,
``:/?#[]@!$&'()*+,;=%``).
- Characters not defined as unreserved by :rfc:`RFC 3986 section 2.3 <3986#section-2.3>`
MUST be :rfc:`percent-encoded <3986#section-2.1>`. That is, all characters except for
alphanumerics and ``-._~``.
- However, if the label is greedy, then "/" MUST NOT be percent-encoded
because greedy labels are meant to span multiple path segments.

Expand Down Expand Up @@ -923,9 +923,9 @@ request:

* "&" is used to separate query string parameter key-value pairs.
* "=" is used to separate query string parameter names from values.
* Reserved characters in keys and values as defined in :rfc:`section 2.2 of RFC3986 <3986#section-2.2>` and `%`
MUST be :rfc:`percent-encoded <3986#section-2.1>` (that is,
``:/?#[]@!$&'()*+,;=%``).
* Characters not defined as unreserved by :rfc:`RFC 3986 section 2.3 <3986#section-2.3>`
MUST be :rfc:`percent-encoded <3986#section-2.1>`. That is, all characters except for
alphanumerics and ``-._~``.
* ``boolean`` values are serialized as ``true`` or ``false``.
* ``timestamp`` values are serialized as an :rfc:`3339`
``date-time`` string by default (for example, ``1985-04-12T23:20:50.52Z``,
Expand Down Expand Up @@ -1367,4 +1367,3 @@ marked with the ``httpPayload`` trait:
structure Message {
message: String
}