Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add graphql introduction #2

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add graphql introduction #2

wants to merge 2 commits into from

Conversation

igorlima
Copy link
Member

@igorlima igorlima commented Feb 1, 2016

An introduction for GraphQL

@RavenHursT
Copy link

@igorlima I've made a number of changes. Please see here: 94f27aa

}
```

It's basically how to get GraphQL up and running on the server-side. As we can see, GraphQL is a contract that has been designed with a flexible syntax making the building of client applications easier. Also, we can see how GraphQL challenges the ReST API architecture. For instance, as we know, [a REST API typically delivers all the data a client UI might need about a resource and leaves it up to the client to extract the bits of data it actually wants to show](https://www.compose.io/articles/using-graphql-with-mongodb/). If some of the data needed by the UI isn't provided by a given resource endpoint, then the client needs to go off to the server and request more data from another URL. Over time, the link between front-end applications and back-end servers can become very rigid. As data gets more complex in structure, it gets harder and slower to query with the traditional REST API.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@igorlima I would suggest removing this paragraph from this article. This article is a tutorial/introduction for implementing a GraphQL server, not an opinion piece. The assertions made here in regards to comparisons between ReSTful communication architecture vs GraphQL, don't really fit into the topic or theme of the article. Furthermore, some of the assertions made here aren't necessarily true and could open up the Fanatics Engineering team to a lot of scrutiny.

@brekk
Copy link

brekk commented Sep 2, 2016

@RavenHursT @igorlima Do y'all wanna merge this still? Trying to get this blog up and running with regular content.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants