Skip to content

Commit 1a18812

Browse files
committed
Break greasing recommendations into sub-sections
1 parent c93ba8c commit 1a18812

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

draft-edm-protocol-greasing.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,12 +100,16 @@ Implementations that receive grease values are required to ignore them. More
100100
background to this approach is given in {{Section 3.3 of ?VIABILITY=RFC9170}}.
101101
This section provides concrete suggestions for its usage.
102102

103+
## Catch-all Handling
104+
103105
It is assumed that endpoints should implement robust and broad extension
104106
handling. A receiver or a parser implementation should not treat grease values
105107
as individually special. Instead of identifying each grease value explicitly,
106108
it is better to have a "catch all" mechanism that can handle receipt of unknown
107109
extensions, whether grease values or not, gracefully or without error.
108110

111+
## Use Unpredictable Grease Values
112+
109113
It is recommended that senders pick an unpredictable grease value to include in
110114
relevant protocol elements. This ensures that receiver greasing requirements are
111115
exercised. Using predictable grease values risks ossification. To increase the
@@ -115,11 +119,15 @@ protocol constraints. For instance, protocols that use 8-bit fields may find it
115119
too costly to dedicate many grease values, while 32-bit or 64-bit fields are
116120
likely to have no limitations.
117121

122+
## Use Grease Values at Unpredictable Times
123+
118124
It is recommended that senders use grease values at unpredictable times or
119125
sequence points during protocol interactions. This avoids receivers
120126
unintentionally ossifying on the occurrence of greasing in the temporal or
121127
spatial domain.
122128

129+
## Defining and Registering Grease Value Ranges
130+
123131
It is recommended that large grease value sets are allocated in protocol
124132
documents by defining a unique algorithm, to increase the chance that
125133
receiver greasing requirements are exercised. However, the choice of algorithm

0 commit comments

Comments
 (0)