Skip to content

Commit 89014b9

Browse files
committed
additional editorial adjustment
1 parent f2bf007 commit 89014b9

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

spec/Section 3 -- Type System.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -383,19 +383,19 @@ all built-in scalars must be omitted for brevity.
383383
**Custom Scalars**
384384

385385
GraphQL services may use custom scalar types in addition to the built-in
386-
scalars. For example, a GraphQL service could define a scalar called `Time`
387-
which, while serialized as a string, conforms to ISO-8601. When querying a field
388-
of type `Time`, you can then rely on the ability to parse the result with an
389-
ISO-8601 parser and use a client-specific primitive for time. Another example of
390-
a potentially useful custom scalar is `URL`, which serializes as a string, but
391-
is guaranteed by the server to be a valid URL.
386+
scalars. For example, a GraphQL service could define a scalar called `UUID`
387+
which, while serialized as a string, conforms to [RFC 4122](https://tools.ietf.org/html/rfc4122).
388+
When querying a field of type `UUID`, you can then rely on the ability to parse
389+
the result with a RFC 4122 compliant parser. Another example of a potentially
390+
useful custom scalar is `URL`, which serializes as a string, but is guaranteed
391+
by the server to be a valid URL.
392392

393393
When defining a custom scalar, GraphQL services should provide a specification
394-
URL via the `specifiedBy` introspection field or the `@specifiedBy` directive.
394+
URL via the `@specifiedBy` directive or the `specifiedBy` introspection field.
395395
This URL must link to a human-readable specification of the data format,
396396
serialization, and coercion rules for the scalar. For example, a GraphQL service
397397
providing a `UUID` scalar may link to RFC 4122, or some custom document defining
398-
a reasonable subset of that RFC. If a scalar specification URL is present,
398+
a reasonable subset of that RFC. If a scalar `specifiedBy` URL is present,
399399
systems and tools that are aware of it should conform to its described rules.
400400

401401
```graphql example
@@ -411,7 +411,7 @@ Custom scalar specification URLs should not be changed once defined. Doing so
411411
would likely disrupt tooling or could introduce breaking changes within the
412412
linked specification's contents.
413413

414-
Built-in scalar types must not provide a specification URL as they are specified
414+
Built-in scalar types must not provide a `specifiedBy` URL as they are specified
415415
by this document.
416416

417417
Note: Custom scalars should also summarize the specified format and provide

0 commit comments

Comments
 (0)