From 373b277f033e12fd9a3a1e12367dd5cf120f3586 Mon Sep 17 00:00:00 2001
From: Achilleas Pipinellis <axilleas@axilleas.me>
Date: Fri, 22 Jan 2016 10:08:57 +0100
Subject: [PATCH] Add note about commit status API deprecation

[ci skip]
---
 doc/api/commits.md    | 9 +++++++--
 doc/ci/api/commits.md | 7 +++++++
 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