|
3 | 3 | **Proposed by:** [Mark Larah](https://twitter.com/mark_larah) - Yelp |
4 | 4 |
|
5 | 5 | This RFC proposes formalizing "Schema Coordinates" - a human readable syntax to |
6 | | -uniquely identify a type, field, or field argument defined in a GraphQL Schema. |
| 6 | +uniquely identify a type, field, field argument, enum value, directive or directive argument defined in a GraphQL Schema. |
7 | 7 |
|
8 | 8 | This should be listed as a non-normative note in the GraphQL specification to |
9 | 9 | serve as an official reference for use by third party tooling. |
10 | 10 |
|
11 | 11 | ## 📜 Problem Statement |
12 | 12 |
|
13 | | -Third party GraphQL tooling and libraries may wish to refer to a field, or set of |
14 | | -fields in a schema. Use cases include documentation, metrics and logging |
| 13 | +GraphQL tooling and libraries may wish to refer to the various components of a GraphQL schema. Use cases include documentation, metrics and logging |
15 | 14 | libraries. |
16 | 15 |
|
17 | 16 |  |
18 | 17 |
|
19 | 18 | _(Example shown from GraphiQL's documentation search tab)_ |
20 | 19 |
|
21 | | -There already exists a convention used by some third party libraries for writing |
| 20 | +There already exists a convention used by some libraries and tools for writing |
22 | 21 | out fields in a unique way for such purposes. However, there is no formal |
23 | 22 | specification or name for this convention. |
24 | 23 |
|
@@ -173,7 +172,7 @@ From the query above, we may calculate the following list of schema coordinates: |
173 | 172 | - `Business.owner` |
174 | 173 | - `Person.name` |
175 | 174 |
|
176 | | -_`Query.searchBusinesses(name)` is also a valid member of the output set. The |
| 175 | +_`Query.searchBusinesses(name:)` is also a valid member of the output set. The |
177 | 176 | serialization algorithm may optionally choose to output all permutations of field |
178 | 177 | arguments used, should this be specified._ |
179 | 178 |
|
@@ -301,7 +300,7 @@ This syntax consciously does not cover the following use cases: |
301 | 300 | ``` |
302 | 301 |
|
303 | 302 | You _can_ select the definition of the `private` directive and its arguments |
304 | | - (with `@private` and `@private(scope)` respectively), but you cannot select the |
| 303 | + (with `@private` and `@private(scope:)` respectively), but you cannot select the |
305 | 304 | application of the `@private` on `User.email`. |
306 | 305 |
|
307 | 306 | For the stated use cases of this RFC, it is more likely that consumers want to |
|
0 commit comments