Skip to content

Commit becf861

Browse files
authored
chore(AIP-136): extend disallowing prepositions rationale (#1511)
1 parent ed03aeb commit becf861

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

aip/general/0136.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -162,9 +162,12 @@ without risk of runtime impact.
162162
Generally, method names with prepositions indicate that a new method is being
163163
used where a field should instead be added to an existing method, or the method
164164
should 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
166167
property-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.

0 commit comments

Comments
 (0)