Skip to content

Conversation

@toumorokoshi
Copy link
Member

There was ambiguity around what to do if preconditions are not supported by an API. This guidance already existed in some form in the AEP, but raising it up front and center to help clarify universally what the behavior should be.

In addition, renaming the aep from /etags and "resource freshness validation" to "preconditions", to match the IETF RFC.

🍱 Types of changes

What types of changes does your code introduce to AEP? Put an x in the boxes
that apply

  • Enhancement
  • New proposal
  • Migrated from google.aip.dev
  • Chore / Quick Fix

📋 Your checklist for this pull request

Please review the AEP Style and Guidance for
contributing to this repository.

General

💝 Thank you!

There was ambiguity around what to do if preconditions are not 
supported by an API. This guidance already existed in some 
form in the AEP, but raising it up front and center to help
clarify universally what the behavior should be.

In addition, renaming the aep from `/etags` and "resource freshness validation"
to "preconditions", to match the IETF RFC.
@toumorokoshi toumorokoshi requested a review from a team as a code owner September 27, 2025 20:36
Copy link
Member

@rambleraptor rambleraptor left a comment

Choose a reason for hiding this comment

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

Can we define preconditions? The first section references ETags and then the guidance just sends you to the (very-long) RFC. Some information on precondition headers would go a long way.

@toumorokoshi
Copy link
Member Author

Can we define preconditions? The first section references ETags and then the guidance just sends you to the (very-long) RFC. Some information on precondition headers would go a long way.

Added!

Copy link
Member

@rambleraptor rambleraptor left a comment

Choose a reason for hiding this comment

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

That sounds fantastic!

Co-authored-by: Olivier Cano <kindermoumoute@users.noreply.github.com>
@toumorokoshi toumorokoshi merged commit 8d11b26 into aep-dev:main Oct 3, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants