From ee832cc908d0c832c7669c69ceb5932628c3f95e Mon Sep 17 00:00:00 2001 From: Michael Staib Date: Tue, 23 Jan 2024 14:34:14 +0100 Subject: [PATCH] Added some explanatory text to the subgraph chapter. (#9) --- spec/Section 2 -- Subgraph.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/spec/Section 2 -- Subgraph.md b/spec/Section 2 -- Subgraph.md index 3b93fbe..0c487c3 100644 --- a/spec/Section 2 -- Subgraph.md +++ b/spec/Section 2 -- Subgraph.md @@ -1,10 +1,15 @@ # Subgraph +The GraphQL Composite Schemas spec refers to downstream GraphQL APIs that have +been designed for composition as subgraphs. These subgraphs may have additional +directives specified in this section to indicate semantics of type system +members in the overall graph. + ## Directives -Composition directives offer instructions for the schema composition process, +Subgraph directives offer instructions for the schema composition process, detailing type system member semantics and specifying type transformations. In -many cases subgraph schemas can be composed without any directives. +some cases subgraph schemas can be composed without any directives. ### @entityResolver @@ -14,7 +19,7 @@ directive @entityResolver on FIELD_DEFINITION Entity resolvers are fields on the query root type of a subgraph that can resolve an entity by a stable key. The stable key is defined by the arguments of -the entity resolver field. +the field. ```graphql example extend type Query { @@ -23,7 +28,7 @@ extend type Query { } extend type Person { - id: ID! + id: ID! # matches the argument of personById } ```