diff options
| author | Nick Thomas <nick@gitlab.com> | 2017-10-18 17:20:59 +0100 |
|---|---|---|
| committer | Nick Thomas <nick@gitlab.com> | 2017-10-18 18:01:37 +0100 |
| commit | 127ef49ff9f66c03ce7ac231c4ca163e7741bce6 (patch) | |
| tree | 1bb1900200e4f4dcb8eb06858324e19731eb0f3a /doc/api/README.md | |
| parent | 9c71fb0de2f0a7482b1a59c673142981ecdab26f (diff) | |
| download | gitlab-ce-127ef49ff9f66c03ce7ac231c4ca163e7741bce6.tar.gz | |
Update GraphQL licensing situation in the docs
Diffstat (limited to 'doc/api/README.md')
| -rw-r--r-- | doc/api/README.md | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/api/README.md b/doc/api/README.md index 3fd4c97e536..3145c9b676f 100644 --- a/doc/api/README.md +++ b/doc/api/README.md @@ -63,7 +63,21 @@ following locations: ## Road to GraphQL -We have changed our plans to move to GraphQL. After reviewing the GraphQL license, anything related to the Facebook BSD plus patent license will not be allowed at GitLab. +Going forward, we will start on moving to +[GraphQL](http://graphql.org/learn/best-practices/) and deprecate the use of +controller-specific endpoints. GraphQL has a number of benefits: + +1. We avoid having to maintain two different APIs. +2. Callers of the API can request only what they need. +3. It is versioned by default. + +It will co-exist with the current v4 REST API. If we have a v5 API, this should +be a compatibility layer on top of GraphQL. + +Although there were some patenting and licensing concerns with GraphQL, these +have been resolved to our satisfaction by the relicensing of the reference +implementations under MIT, and the use of the OWF license for the GraphQL +specification. ## Basic usage |