diff --git a/spec/Section 1 -- Overview.md b/spec/Section 1 -- Overview.md index e35f74c..7fc7721 100644 --- a/spec/Section 1 -- Overview.md +++ b/spec/Section 1 -- Overview.md @@ -4,10 +4,10 @@ The GraphQL Composite Schemas specification describes how multiple GraphQL schemas, known as _source schemas_, are combined into a single unified GraphQL schema called the _composite schema_. -For clients querying the GraphQL composite schema, the implementation details and -complexities of the underlying distributed systems are hidden. The observable -behavior of the distributed GraphQL executor is the same as that of a standard -GraphQL executor as described by the GraphQL specification. +For clients querying the GraphQL composite schema, the implementation details +and complexities of the underlying distributed systems are hidden. The +observable behavior of the distributed GraphQL executor is the same as that of a +standard GraphQL executor as described by the GraphQL specification. This specification focuses on two core components to allow interoperability between tooling and gateways from different implementers, the schema composition @@ -17,15 +17,16 @@ and the execution. multiple source schemas into a single GraphQL schema that is annotated with execution directives and is referred to as the composite schema. -- **Execution**: The distributed GraphQL executor specifies the core execution behavior and algorithms. +- **Execution**: The distributed GraphQL executor specifies the core execution + behavior and algorithms. The GraphQL Composite Schemas spec describes a collaborative approach towards build a single schema composed from multiple _source schemas_ by specifying the algorithms to merge different GraphQL _subgraph_ schemas into a single _composite schema_. -Two _source schema_ exposing a type with the same name form a _composite type_ in the -_composite schema_. +Two _source schema_ exposing a type with the same name form a _composite type_ +in the _composite schema_. ```graphql example # source schema 1 @@ -59,7 +60,8 @@ system members to the composition. The result of a successful composition is a single GraphQL schema that is annotated with execution directives. This schema document represents the -configuration for the distributed GraphQL executor and is called _composite schema_. +configuration for the distributed GraphQL executor and is called _composite +schema_. ## Entities