Add note about commit status API deprecation

[ci skip]

2 files changed, 14 insertions, 2 deletions

diff --git a/doc/api/commits.md b/doc/api/commits.md
index 4008629e0a2..e4d436b8e52 100644
--- a/doc/api/commits.md
+++ b/doc/api/commits.md
@@ -211,7 +211,12 @@ Example response:
 }
 ```
 
-## Get the status of a commit
+## Commit status
+
+Since GitLab 8.1, this is the new commit status API. The documentation in
+[ci/api/commits](../ci/api/commits.md) is deprecated.
+
+### Get the status of a commit
 
 Get the statuses of a commit in a project.
 
@@ -285,7 +290,7 @@ Example response:
 ]
 ```
 
-## Post the build status to a commit
+### Post the build status to a commit
 
 Adds or updates a build status of a commit.
 
diff --git a/doc/ci/api/commits.md b/doc/ci/api/commits.md
index 4df7afc6c52..871de7abcce 100644
--- a/doc/ci/api/commits.md
+++ b/doc/ci/api/commits.md
@@ -1,5 +1,12 @@
 # Commits API
 
+**DEPRECATED**
+
+Since GitLab 8.1, there is a new commit status API. Please see the [revised
+documentation](../../api/commits.md#commit-status).
+
+---
+
 __Authentication is done by GitLab CI project token__
 
 ## Commits