Clearer text for application errors #3226
Conversation
This cribs Lucas' proposed tweak and makes a few other tiny adjustments. Closes #2850.
martinthomson
added
editorial
draft-ietf-quic-transport.md
Outdated
| streams that are prematurely cancelled by either endpoint. | ||
| Resetting a stream without the involvement of the application protocol could | ||
| cause the application protocol to enter an unrecoverable state. Application | ||
| protocols might require certain streams to be reliably delivered in order to |
There was a problem hiding this comment.
to split hairs what does "might require certain streams to be reliably delivered" really mean here? Streams produce reliable byte streams. Is the intent more to say something like "applications expect streams to run to completion" and that premature exit causes that assumption to break?
There was a problem hiding this comment.
+1 to Lucas point. Personally, I'd delete this sentence because I think it's not adding much and as written it's confusing.
There was a problem hiding this comment.
It's the "critical stream" idea from HTTP/3 -- if you blow up a request stream, the HTTP connection is fine. If you blow up a QPACK stream, the connection dies in flames. Some streams are application-critical, and only the application knows which, so only the application can decide which streams to kill. In a transport world, though, "reliably delivered" brings up different overtones. Maybe "Resetting certain streams could disrupt the consistency of application-layer state between the endpoints."?
As to confusion, this is the rationale for the restriction in the previous paragraph. Maybe putting the rationale first and following with "Therefore, RESET_STREAM MUST only be instigated...." would help?
draft-ietf-quic-transport.md
Outdated
| streams that are prematurely cancelled by either endpoint. | ||
| Resetting a stream without the involvement of the application protocol could | ||
| cause the application protocol to enter an unrecoverable state. Application | ||
| protocols might require certain streams to be reliably delivered in order to |
There was a problem hiding this comment.
+1 to Lucas point. Personally, I'd delete this sentence because I think it's not adding much and as written it's confusing.
Co-Authored-By: Mike Bishop <mbishop@evequefou.be>
This cribs Lucas' proposed tweak and makes a few other tiny adjustments.
Closes #2850.