|
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