diff options
| author | Douwe Maan <douwe@gitlab.com> | 2017-06-08 16:32:54 +0300 |
|---|---|---|
| committer | Douwe Maan <douwe@gitlab.com> | 2017-06-08 16:32:54 +0300 |
| commit | a982a45349d092846d75892195e2f1be780741e5 (patch) | |
| tree | 9e84188f39fe1e4a89b308b2c2b05b1a0c7269f7 | |
| parent | 63721c0d46bc1645edea67d1b88ad33042350c8f (diff) | |
| parent | d540699b776630262c348a8399f8f31e8e778346 (diff) | |
Merge branch 'sh-document-road-to-graphql' into 'master'
Add text documenting that v5 of the API will be GraphQL
See merge request !11998
| -rw-r--r-- | doc/api/README.md | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/api/README.md b/doc/api/README.md index e1d4009dedc..2175b305e02 100644 --- a/doc/api/README.md +++ b/doc/api/README.md @@ -55,6 +55,15 @@ following locations: - [V3 to V4](v3_to_v4.md) - [Version](version.md) +## Road to GraphQL + +API v4 will be the last REST API that we support. Going forward, we will start +on moving to GraphQL 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. + ### Internal CI API The following documentation is for the [internal CI API](ci/README.md): |