From f606d9cc6d16597b95fafff7a77599a48df9db25 Mon Sep 17 00:00:00 2001 From: "S.Hale" Date: Wed, 13 Feb 2019 16:38:51 +0000 Subject: [PATCH] Add GraphQL stub and opening paragraph for guide (#34992) * Add GraphQL opening paragraph for guide * Update guide/english/graphql/index.md Co-Authored-By: s-Hale --- guide/english/graphql/index.md | 29 +++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/guide/english/graphql/index.md b/guide/english/graphql/index.md index 8fe5e9a0e6..b802de2a46 100644 --- a/guide/english/graphql/index.md +++ b/guide/english/graphql/index.md @@ -2,21 +2,34 @@ title: GraphQL --- -## GraphQL +# GraphQL +Developed by Facebook and launched in 2015, GraphQL is an API standard defined by its use of a declarative request that returns only the data the client requested, in the shape they desire. Unlike traditional REST APIs, GraphQL allows the client side of an application to ask for the exact pieces of data it requires in a readable way. -GraphQL is a query language developed by Facebook that provides a syntax to query data in from API. Unlike traditional REST APIs, GraphQL allows the client side of an application to ask for the exact pieces of data it requires in a readable way. +An alternative to the fixed endpoints of REST, its flexible approach makes aggregating data from multiple sources simpler, analytics are more refined and minimising the data fetched puts less pressure on slower networks, which speeds up responses for users GraphQL schemas are often coupled with frameworks such as [Relay](https://facebook.github.io/relay/) or [Apollo](https://www.apollographql.com/) to make these requests from the client. GraphQL powers how [GatsbyJS](https://www.gatsbyjs.org) fetches data. - -### Installation - +## Installation From the command line run: -```bash +```sh npm init npm install graphql --save ``` -#### More Information: -For tutorials and more information check out the GraphQL official site: [Getting Started With GraphQL.js](https://graphql.org/graphql-js/) +## Queries + + +## Mutations + + +## Resolvers + + +## Schemas + + +## Additional Resources +- For tutorials and more information check out the GraphQL official site: [Getting Started With GraphQL.js](https://graphql.org/graphql-js/) +- [GraphQL Site and Documentation](https://graphql.org/) +- [How to GraphQL Tutorial](https://www.howtographql.com/)