Skip to content

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
Co-authored-by: Vincent Biret <vincentbiret@hotmail.com>
Co-authored-by: Karen Etheridge <ether@cpan.org>
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.

@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
@ralfhandl ralfhandl merged commit d17c44d into OAI:v3.2-dev Aug 25, 2025
2 checks passed
@handrews handrews deleted the set-cookie-example branch August 27, 2025 17:32
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.

6 participants