diff --git a/guide/english/graphql/index.md b/guide/english/graphql/index.md index c52b0bd389..b3f2ff479a 100644 --- a/guide/english/graphql/index.md +++ b/guide/english/graphql/index.md @@ -18,7 +18,30 @@ npm install graphql --save ``` ## Queries - + +A query is the shape of the request that get back the exact data you asked for, not the whole object like in REST approach. You can write your query like that:- + +``` +{ + hero { + name + } +} +``` + +and then the output is like that:- + +``` +{ + "data": { + "hero": { + "name": "R2-D2" + } + } +} +``` + +note that the returned data has a special structure which starts with "data" and it has the same structure as the request. ## Mutations