-
Notifications
You must be signed in to change notification settings - Fork 13
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
Adopt AEP-202: Fields #155
base: main
Are you sure you want to change the base?
Conversation
Added a few high-level comments - will do a more thorough read of the PR once those are resolved. |
Added the proto file for |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Replied to comments, but have to send this to take myself out of the attention set.
Should we generalize this guidance to cover |
We should do that in a subsequent PR. I think they'll be a lot of conversation about that. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good. 👍
that are validated by the service, so conveying the format to the user ahead of | ||
time is critical to their experience. | ||
|
||
#### Why discourage primitive equality comparisons? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It seems like there should be actual guidance that this explains. I think the rationale makes sense, we just need the corresponding guidance.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, this is too vague as-is. The biggest pieces of guidance I can think of are:
- Fields that follow a pattern must have that pattern specified as proto-validate
- Both the request + response fields must have the validation + and the validations must match (if applicable)
- Returning a value that does not match the validation must return an error message.
Any others you can think of?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I meant specifically for "Why discourage primitive equality comparisons?"
Which guidance discourages primitive equality comparisons?
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Co-authored-by: Richard Frankel <richard@frankel.tv>
Addresses #148
This adopts AEP-202: Fields
Note: this still uses the google.api.field_info proto type.