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.

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

Update request authority documentation #122

Merged
merged 1 commit into from
Aug 1, 2024
Merged

Conversation

lann
Copy link
Contributor

@lann lann commented Jul 25, 2024

The existing wording refers to a "request's authority", which is not clearly defined by HTTP specs.

This rewords it to refer to the "request's target URI authority" - the "authority" part of the "target URI" of the request, which is well-defined: https://httpwg.org/http-core/draft-ietf-httpbis-semantics-latest.html#target.resource

Also normalize some word casing to match the HTTP Semantics doc.

@lann lann marked this pull request as draft July 25, 2024 14:21
@lann
Copy link
Contributor Author

lann commented Jul 25, 2024

I'll fix up the branch if the rewording looks good to folks.

Copy link
Member

@lukewagner lukewagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, that's a nice succinct fix.

@lann
Copy link
Contributor Author

lann commented Jul 26, 2024

The HTTP/2 spec makes it even more clear: https://www.rfc-editor.org/rfc/rfc7540.html#section-8.1.2.3

The ":authority" pseudo-header field includes the authority portion of the target URI

@lann
Copy link
Contributor Author

lann commented Jul 26, 2024

Updated 0.3 draft and regenerated markdown.

@lann lann marked this pull request as ready for review July 26, 2024 14:30
The existing wording refers to a "request's authority", which is not
well-defined. This rewords it to refer to the "request's target URI
authority" - the "authority" part of the "target URI" of the request,
which is well-defined.
@ricochet ricochet merged commit c893526 into WebAssembly:main Aug 1, 2024
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants