File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -162,9 +162,12 @@ without risk of runtime impact.
162162Generally, method names with prepositions indicate that a new method is being
163163used where a field should instead be added to an existing method, or the method
164164should use a distinct verb. For example, if a ` CreateBook ` message already
165- exists and you are considering adding ` CreateBookFromDictation ` , consider a ` TranscribeBook ` method instead. Similarly, if there is desire for a
165+ exists and you are considering adding ` CreateBookFromDictation ` , consider a
166+ ` TranscribeBook ` method instead. Similarly, if there is desire for a
166167property-specific look-up method, instead of ` GetBookByAuthor ` consider a
167- ` SearchBooks ` with an ` author ` field as a search dimension.
168+ ` SearchBooks ` with an ` author ` field as a search dimension. This helps prevent
169+ an explosion of hyper-focused methods that bloat API and client surfaces, and
170+ add complexity to both managing and consuming the API.
168171
169172[ get ] : ./0131.md
170173[ list ] : ./0132.md
@@ -185,6 +188,7 @@ languages.
185188
186189## Changelog
187190
191+ - ** 2025-05-12:** Extend disallowing prepositions rationale.
188192- ** 2025-01-09:** Add original rationale for disallowing prepositions in names.
189193- ** 2023-11-16:** Included link to AIP-127 "HTTP and gRPC Transcoding" for guidance on body definition.
190194- ** 2023-05-16:** Added prohibition of the term "async" within RPC names.
You can’t perform that action at this time.
0 commit comments