Skip to content

Commit 7485a34

Browse files
authored
Reformat the parts of an execution request (#1090)
1 parent 8076f1e commit 7485a34

File tree

1 file changed

+15
-12
lines changed

1 file changed

+15
-12
lines changed

spec/Section 6 -- Execution.md

+15-12
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,21 @@ A GraphQL service generates a response from a request via execution.
44

55
:: A _request_ for execution consists of a few pieces of information:
66

7-
- The schema to use, typically solely provided by the GraphQL service.
8-
- A {Document} which must contain GraphQL {OperationDefinition} and may contain
9-
{FragmentDefinition}.
10-
- Optionally: The name of the Operation in the Document to execute.
11-
- Optionally: Values for any Variables defined by the Operation.
12-
- An initial value corresponding to the root type being executed. Conceptually,
13-
an initial value represents the "universe" of data available via a GraphQL
14-
Service. It is common for a GraphQL Service to always use the same initial
15-
value for every request.
16-
17-
Given this information, the result of {ExecuteRequest()} produces the response,
18-
to be formatted according to the Response section below.
7+
- {schema}: The schema to use, typically solely provided by the GraphQL service.
8+
- {document}: A {Document} which must contain GraphQL {OperationDefinition} and
9+
may contain {FragmentDefinition}.
10+
- {operationName} (optional): The name of the Operation in the Document to
11+
execute.
12+
- {variableValues} (optional): Values for any Variables defined by the
13+
Operation.
14+
- {initialValue} (optional): An initial value corresponding to the root type
15+
being executed. Conceptually, an initial value represents the "universe" of
16+
data available via a GraphQL Service. It is common for a GraphQL Service to
17+
always use the same initial value for every request.
18+
19+
Given this information, the result of {ExecuteRequest(schema, document,
20+
operationName, variableValues, initialValue)} produces the response, to be
21+
formatted according to the Response section below.
1922

2023
Note: GraphQL requests do not require any specific serialization format or
2124
transport mechanism. Message serialization and transport mechanisms should be

0 commit comments

Comments
 (0)