@@ -36,35 +36,35 @@ platform for tool-building.
36
36
37
37
GraphQL has a number of design principles:
38
38
39
- * ** Hierarchical** : Most product development today involves the creation and
40
- manipulation of view hierarchies. To achieve congruence with the structure
41
- of these applications, a GraphQL query itself is structured hierarchically.
42
- The query is shaped just like the data it returns. It is a natural
43
- way for clients to describe data requirements.
44
-
45
39
* ** Product-centric** : GraphQL is unapologetically driven by the requirements
46
40
of views and the front-end engineers that write them. GraphQL starts with
47
41
their way of thinking and requirements and builds the language and runtime
48
42
necessary to enable that.
49
43
44
+ * ** Hierarchical** : Most product development today involves the creation and
45
+ manipulation of view hierarchies. To achieve congruence with the structure
46
+ of these applications, a GraphQL request itself is structured hierarchically.
47
+ The request is shaped just like the data in its response. It is a natural way
48
+ for clients to describe data requirements.
49
+
50
50
* ** Strong-typing** : Every GraphQL service defines an application-specific
51
- type system. Queries are executed within the context of that type system.
52
- Given a query , tools can ensure that the query is both syntactically
53
- correct and valid within the GraphQL type system before execution, i.e. at
51
+ type system. Requests are executed within the context of that type system.
52
+ Given a GraphQL operation , tools can ensure that it is both syntactically
53
+ correct and valid within that type system before execution, i.e. at
54
54
development time, and the service can make certain guarantees about the shape
55
55
and nature of the response.
56
56
57
- * ** Client-specified queries ** : Through its type system, a GraphQL service
57
+ * ** Client-specified response ** : Through its type system, a GraphQL service
58
58
publishes the capabilities that its clients are allowed to consume. It is
59
59
the client that is responsible for specifying exactly how it will consume
60
- those published capabilities. These queries are specified at field-level
61
- granularity. In the majority of client-server applications written
62
- without GraphQL, the service determines the data returned in its various
63
- scripted endpoints. A GraphQL query , on the other hand, returns exactly what
64
- a client asks for and no more.
60
+ those published capabilities. These requests are specified at field-level
61
+ granularity. In the majority of client-server applications written without
62
+ GraphQL, the service determines the shape of data returned from its various
63
+ endpoints. A GraphQL response , on the other hand, contains exactly what a
64
+ client asks for and no more.
65
65
66
66
* ** Introspective** : GraphQL is introspective. A GraphQL service's type system
67
- must be queryable by the GraphQL language itself, as will be described in this
67
+ can be queryable by the GraphQL language itself, as will be described in this
68
68
specification. GraphQL introspection serves as a powerful platform for
69
69
building common tools and client software libraries.
70
70
0 commit comments