search

bagder / http3-explained

A document describing the HTTP/3 and QUIC protocols
https://http3-explained.haxx.se/
Creative Commons Attribution 4.0 International
2.14k stars 194 forks source link

[en] rephrase RFC terms #116

Closed ebiiim closed 5 years ago

ebiiim commented 5 years ago

The MUST keyword is used in the IETF I-D.

bagder commented 5 years ago

Yes, the QUIC drafts use the RFC 2119 language but this is supposed to be an explainer book/document written in plain English. In plain English we don't write words in all-caps to emphasize them. Therefor, I don't think we should do this change.

ebiiim commented 5 years ago

Since there is a "MUST NOT" on the line after this line which is based on the same section in the draft, I thought you were using RFC 2119 language there, so I thought this was just a typo.

that says that a server MUST NOT send more than three times the size of the

If this is what you intended, it's ok to close this PR.

bagder commented 5 years ago

I would rather have us rephrase that to not use RFC "lingo"...

ebiiim commented 5 years ago

I tried doing it.

bagder commented 5 years ago

Thanks!