Skip to content

Commit eb775e8

Browse files
committed
Clarify that resource type naming isn't completely free of constraints
1 parent 825ae9f commit eb775e8

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

aip/general/0123.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@ placement:
1111

1212
Most APIs expose _resources_ (their primary nouns) which users are able to
1313
create, retrieve, and manipulate. APIs are allowed to name their resource types
14-
as they see fit, and are only required to ensure uniqueness within that API.
15-
This means that it is possible (and often desirable) for different APIs to use
16-
the same type name. For example, a Memcache and Redis API would both want to
17-
use `Instance` as a type name.
14+
reasonably freely (within the requirements of this AIP), and are only required
15+
to ensure uniqueness within that API. This means that it is possible (and often
16+
desirable) for different APIs to use the same type name. For example, a Memcache
17+
and Redis API would both want to use `Instance` as a type name.
1818

1919
When mapping the relationships between APIs and their resources, however, it
2020
becomes important to have a single, globally-unique type name. Additionally,

0 commit comments

Comments
 (0)