Skip to content

Commit fe559ea

Browse files
committed
More editorial
1 parent a7c6ad5 commit fe559ea

File tree

1 file changed

+13
-14
lines changed

1 file changed

+13
-14
lines changed

spec/Section 4 -- Introspection.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -529,7 +529,7 @@ Fields\:
529529
directly expressible in the type system. This may include experimental GraphQL
530530
features (such as new syntax or behavior), protocol support (such as GraphQL
531531
over WebSockets), or additional operational metadata (such as release
532-
identifiers). Capabilities may be supplied by the GraphQL implementation, by the
532+
identifiers). Capabilities may be supplied by the GraphQL implementation, the
533533
service, or both.
534534

535535
The `__Service.capabilities` field exposes a _capability_ list. A _capability_
@@ -538,13 +538,13 @@ consists of a capability identifier and optionally a string value.
538538
**Capability identifier**
539539

540540
A capability identifier is a string value composed of two or more segments
541-
separated by a period (`.`). Each segment must begin with a letter and must
542-
contain only alphanumeric characters and hyphens (`[a-zA-Z][a-zA-Z0-9-]*`).
543-
These constraints are inspired by reverse domain name notation to encourage
544-
global uniqueness and collision-resistance. Unlike the domain name system,
545-
capability identifiers are case sensitive. Identifiers beginning with the prefix
546-
{"org.graphql."} are reserved and must not be used outside of official GraphQL
547-
Foundation specifications. Further, identifiers beginning with the prefix
541+
separated by a period (`.`). Each segment must begin with an ASCII letter, and
542+
must contain only ASCII letters, digits and hyphens. These constraints are
543+
inspired by reverse domain name notation to encourage global uniqueness and
544+
collision-resistance. Unlike the domain name system, capability identifiers are
545+
case sensitive. Identifiers beginning with the prefix {"org.graphql."} are
546+
reserved and must not be used outside of official GraphQL Foundation
547+
specifications. Further, identifiers beginning with the prefix
548548
{"org.graphql.http."} are reserved for use by the GraphQL-over-HTTP
549549
specification, and identifiers beginning with the prefix {"org.graphql.rfc."}
550550
are reserved for RFC proposals.
@@ -567,12 +567,11 @@ interoperability, while avoiding tight coupling to specific implementations.
567567

568568
**Capability value**
569569

570-
The value assigned to a given capability may either be {null} to indicate that
571-
the capability is supported and requires no additional information, or a string
572-
to provide additional information. For example {"org.graphql.onError"} does not
573-
require additional information and thus uses the value {null}, whereas
574-
{"org.graphql.defaultErrorBehavior"} needs the {value} to indicate which _error
575-
behavior_ is the default.
570+
The value assigned to a given capability may either be {null} to simply indicate
571+
the capability is supported, or a string to provide additional information. For
572+
example {"org.graphql.onError"} does not require additional information and thus
573+
uses the value {null}, whereas {"org.graphql.defaultErrorBehavior"} needs the
574+
{value} to indicate which _error behavior_ is the default.
576575

577576
**Specified capabilities**
578577

0 commit comments

Comments
 (0)