search

aip-dev / google.aip.dev

API Improvement Proposals. https://aip.dev/
Other
1.08k stars 495 forks source link

AIP 128/163 inconsistent guidance #1395

Open michael76484 opened 2 months ago

michael76484 commented 2 months ago

AIP-128 Declarative-friendly interfaces says:

Resources should provide change validation: see AIP-163.

AIP-163 Change validation says:

A resource that is declarative-friendly (AIP-128) must include a validate_only field on methods that mutate the resource.

There seems to be an inconsistency between the should and must in these statements.