-
Notifications
You must be signed in to change notification settings - Fork 166
Description
In #3329, "Header" was added to the "Cookie" section to address some reviewer comments.
Diff: 07e5151#diff-c96f4fab694f25d91c3ae6f4cd68ae735dbcb33dcbb2f4b79a13675b293caa7bL553
Current:
4. Server Requirements
4.1. Set-Cookie Header
4.1.1. Syntax
...
4.2. Cookie Header
4.2.1. Syntax
...
As defined in HTTP Semantics RFC9110, "Cookie Header" should be explicitly written as "Cookie Header Field". Alternatively, if it's not intended to apply only to headers (but also to trailers), it could be "Cookie Field".
Sections 4.1 and 4.2 cover general syntax and semantics, so using just "Field" seems reasonable:
4. Server Requirements
4.1. Set-Cookie Field
4.1.1. Syntax
...
4.2. Cookie Field
4.2.1. Syntax
...
However, this draft only mentions "Cookie/Set-Cookie Header Fields" and does not reference trailers. (I'm not sure if cookies work with trailer fields.)
Using "Header Field" also seems reasonable, but in that case:
4. Server Requirements
4.1. Set-Cookie Header Field
4.1.1. Syntax
...
4.2. Cookie Header Field
4.2.1. Syntax
...
5. User Agent Requirements
5.1. Subcomponent Algorithms
...
5.6. The Set-Cookie Header Field
5.7. Storage Model
5.8. Retrieval Model
5.8.1. The Cookie Header Field
Having the same section titles with or without "The" is a bit confusing to me.