Skip to content

Commit 77d4977

Browse files
authored
Merge pull request graphql#1013 from tlblessing/patch-1
Update Introduction.md
2 parents f7a0931 + a1670da commit 77d4977

File tree

1 file changed

+16
-7
lines changed

1 file changed

+16
-7
lines changed

src/content/learn/Introduction.md

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,18 @@ permalink: /learn/
77
next: /learn/queries/
88
---
99

10-
> Learn about GraphQL, how it works, and how to use it in this series of articles. Looking for documentation on how to build a GraphQL service? There are libraries to help you implement GraphQL in [many different languages](/code/). For an in-depth learning experience with practical tutorials, visit the [How to GraphQL](https://www.howtographql.com) fullstack tutorial website. We have also partnered with edX to create a free online course, [Exploring GraphQL: A Query Language for APIs](https://www.edx.org/course/exploring-graphql-a-query-language-for-apis).
10+
> Learn about GraphQL, how it works, and how to use it. Looking for documentation on how to build a GraphQL service?
11+
> There are libraries to help you implement GraphQL in [many different languages](/code/). For an in-depth learning experience
12+
> with practical tutorials, see [How to GraphQL](https://www.howtographql.com). Check out the
13+
> free online course,
14+
> [Exploring GraphQL: A Query Language for APIs](https://www.edx.org/course/exploring-graphql-a-query-language-for-apis).
1115
12-
GraphQL is a query language for your API, and a server-side runtime for executing queries by using a type system you define for your data. GraphQL isn't tied to any specific database or storage engine and is instead backed by your existing code and data.
16+
GraphQL is a query language for your API, and a server-side runtime for executing queries using a type system you define for your
17+
data. GraphQL isn't tied to any specific database or storage engine and is instead backed by your existing code and data.
1318

14-
A GraphQL service is created by defining types and fields on those types, then providing functions for each field on each type. For example, a GraphQL service that tells us who the logged in user is (`me`) as well as that user's name might look something like this:
19+
A GraphQL service is created by defining types and fields on those types, then providing functions for each field on each type.
20+
For example, a GraphQL service that tells you who the logged in user is (`me`) as well as that user's name might look
21+
like this:
1522

1623
```graphql
1724
type Query {
@@ -36,9 +43,11 @@ function User_name(user) {
3643
}
3744
```
3845

39-
Once a GraphQL service is running (typically at a URL on a web service), it can receive GraphQL queries to validate and execute. A received query is first checked to ensure it only refers to the types and fields defined, then runs the provided functions to produce a result.
46+
After a GraphQL service is running (typically at a URL on a web service), it can receive GraphQL queries to validate and execute.
47+
The service first checks a query to ensure it only refers to the types and fields defined, and then runs the provided functions
48+
to produce a result.
4049

41-
For example the query:
50+
For example, the query:
4251

4352
```graphql
4453
{
@@ -48,7 +57,7 @@ For example the query:
4857
}
4958
```
5059

51-
Could produce the JSON result:
60+
Could produce the following JSON result:
5261

5362
```json
5463
{
@@ -58,4 +67,4 @@ Could produce the JSON result:
5867
}
5968
```
6069

61-
Learn more about GraphQL — the query language, type system, how the GraphQL service works, as well as best practices for using GraphQL in the articles written in this section; they help to solve common problems.
70+
To learn more, click **Continue Reading**.

0 commit comments

Comments
 (0)