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
Take a stab at refactoring the use of Note:
.
#258
Conversation
This is just a start. While these are editorial changes they will definitely require discussion for how it's best to change each Note:.
draft-ietf-quic-qlog-h3-events.md
Outdated
This event can contain any number of unspecified fields. This is to | ||
allow representation of unknown settings like grease settings or parameters of | ||
non-standard extensions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is what we're trying to say?
This event can contain any number of unspecified fields. This is to | |
allow representation of unknown settings like grease settings or parameters of | |
non-standard extensions. | |
This event can contain any number of unspecified fields. This | |
allows for representation of reserved settings (aka grease) or ad-hoc support for extension settings | |
that do not have a related qlog schema definition . |
draft-ietf-quic-qlog-h3-events.md
Outdated
@@ -247,7 +246,7 @@ HTTPParametersRestored = { | |||
~~~ | |||
{: #http-parametersrestored-def title="HTTPParametersRestored definition"} | |||
|
|||
Note that, like for parameters_set above, this event can contain any number of | |||
Similarly to HTTPParametersSet this event can contain any number of |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Similarly to HTTPParametersSet this event can contain any number of | |
Similar to HTTPParametersSet, this event can contain any number of |
draft-ietf-quic-qlog-h3-events.md
Outdated
@@ -247,7 +246,7 @@ HTTPParametersRestored = { | |||
~~~ | |||
{: #http-parametersrestored-def title="HTTPParametersRestored definition"} | |||
|
|||
Note that, like for parameters_set above, this event can contain any number of | |||
Similarly to HTTPParametersSet this event can contain any number of | |||
unspecified fields to allow for additional and custom settings. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
unspecified fields to allow for additional and custom settings. | |
unspecified fields to allow for reserved or extension settings. |
draft-ietf-quic-qlog-h3-events.md
Outdated
This event is logged at the time the frame header is created. A frame payload | ||
may require multiple write operations that are logged using data_moved events. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This event is logged at the time the frame header is created. A frame payload | |
may require multiple write operations that are logged using data_moved events. | |
might extend over multiple write operations, which would be logged using multiple data_moved events. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
This is just a start. While these are editorial changes they will
definitely require discussion for how it's best to change each Note:.