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

SEMANTICS uses named references inconsistently #815

Closed
MikeBishop opened this issue Mar 26, 2021 · 5 comments
Closed

SEMANTICS uses named references inconsistently #815

MikeBishop opened this issue Mar 26, 2021 · 5 comments

Comments

@MikeBishop
Copy link
Contributor

HTTP3 is a named reference, but the other HTTP RFCs are referenced only by RFC number. That makes some sense for the older HTTP RFCs which are being obsoleted by this document, but I'd expect at least H2 and H3 to have parity.

@reschke
Copy link
Contributor

reschke commented Mar 26, 2021

I happen to agree, and that's the plan once the RFC # is assigned.

@reschke
Copy link
Contributor

reschke commented Mar 28, 2021

Re-opening so we can track it once we know HTTP3's RFC number (likely not before AUTH48).

@reschke reschke self-assigned this Mar 28, 2021
@royfielding
Copy link
Member

I vaguely recall including a note to the RFC editor for that purpose, like in

https://tools.ietf.org/id/draft-ietf-ipr-submission-rights-08.txt

This memo updates RFC 2026, and, with RFC XXXY, replaces Section 10 of RFC 2026. [note to RFC editor: replace XXXY with number of IETF IPR]

@reschke
Copy link
Contributor

reschke commented Apr 29, 2021

FWIW, we should also discuss whether we stick with the anchor names for the core specs, or whether we switch them to RFCxxxx.

(I really don't care that much, but maybe we shouldn't discuss this during AUTH48)

@MikeBishop
Copy link
Contributor Author

Personally, I like the anchor names, provided they give readers more mental context for what they're being referred to. Obviously it doesn't matter for things like "TLS 1.3 ([TLS])", but are more useful in things like "esoteric concept; see Section foobar of [BAZ]."

reschke added a commit that referenced this issue May 26, 2021
For "HTTP3" add an RFC Editor note to rename to "RFCnnn" before publication (fixes #815)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

No branches or pull requests

3 participants