@@ -383,19 +383,19 @@ all built-in scalars must be omitted for brevity.
383383** Custom Scalars**
384384
385385GraphQL 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
393393When 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 .
395395This URL must link to a human-readable specification of the data format,
396396serialization, and coercion rules for the scalar. For example, a GraphQL service
397397providing 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,
399399systems 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
411411would likely disrupt tooling or could introduce breaking changes within the
412412linked 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
415415by this document .
416416
417417Note : Custom scalars should also summarize the specified format and provide
0 commit comments