Skip to content

v3.2: Update Set-Cookie example for recent changes #4903

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

Open
wants to merge 3 commits into
base: v3.2-dev
Choose a base branch
from

Conversation

handrews
Copy link
Member

Changes to our understanding of percent-encoding and headers have made the previous example incorrect. This brings it into agreement with the new recommendations.

This also explains how percent-encoding and other escaping is handled, and links to the updated Appendix D which provids more detail including a link to the IETF draft update of the cookie RFC that clarifies this.

  • schema changes are included in this pull request
  • schema changes are needed for this pull request but not done yet
  • no schema changes are needed for this pull request

Changes to our understanding of percent-encoding and headers
have made the previous example incorrect.  This brings it into
agreement with the new recommendations.

This also explains how percent-encoding and other escaping is
handled, and links to the updated Appendix D which provids more
detail including a link to the IETF draft update of the cookie
RFC that clarifies this.
@handrews handrews added this to the v3.2.0 milestone Aug 21, 2025
@handrews handrews added examples requests for more or better examples in the specification headers labels Aug 21, 2025
@handrews handrews requested review from a team as code owners August 21, 2025 16:14
```
In an HTTP message, the serialized example with Expires would look like:
In an HTTP message, the serialized example would look like:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think I understand why the urlSafeData isn't in the following example

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Error- I will fix.

Co-authored-by: Vincent Biret <[email protected]>
Co-authored-by: Karen Etheridge <[email protected]>
Copy link
Member Author

@handrews handrews left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll fix the remaining thing soon- I think all suggestions are either accepted or I've replied with why I do not think they should be, at least as part of this PR.

```
In an HTTP message, the serialized example with Expires would look like:
In an HTTP message, the serialized example would look like:
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Error- I will fix.

@handrews
Copy link
Member Author

@lornajane I have fixed the example and added a note with further explanation about why this looks different from "Hello, world!" in the cookie input parameter example from PR #4902.

@karenetheridge as with the other PR, I will gladly approve a PR changing the formatting for dataValue in all examples at once, after this is merged.

@ralfhandl ralfhandl requested review from a team, lornajane, karenetheridge and baywet August 22, 2025 07:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
examples requests for more or better examples in the specification headers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants