From c5b429f099d8b6b71225a96f111d65c97f15d2a8 Mon Sep 17 00:00:00 2001
From: Tomasz Maczukin <tomasz@maczukin.pl>
Date: Thu, 14 Jan 2016 11:08:33 +0100
Subject: [PATCH] Add mofications to triggers API documentation [ci skip]

---
 doc/api/build_triggers.md | 44 +++++++++++----------------------------
 1 file changed, 12 insertions(+), 32 deletions(-)

diff --git a/doc/api/build_triggers.md b/doc/api/build_triggers.md
index 14f7e3534bd..4a12e962b62 100644
--- a/doc/api/build_triggers.md
+++ b/doc/api/build_triggers.md
@@ -1,27 +1,23 @@
 # Build triggers
 
+You can read more about [triggering builds through the API](../ci/triggers/README.md).
+
 ## List project triggers
 
-Get a list of project triggers
+Get a list of project's build triggers.
 
 ```
 GET /projects/:id/triggers
 ```
 
-### Parameters
-
 | Attribute | Type    | required | Description         |
 |-----------|---------|----------|---------------------|
-| id        | integer | yes      | The ID of a project |
-
-### Example of request
+| `id`      | integer | yes      | The ID of a project |
 
 ```
 curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/triggers"
 ```
 
-### Example of response
-
 ```json
 [
     {
@@ -43,27 +39,21 @@ curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3
 
 ## Get trigger details
 
-Get details of trigger of a project
+Get details of project's build trigger.
 
 ```
 GET /projects/:id/triggers/:token
 ```
 
-### Parameters
-
 | Attribute | Type    | required | Description              |
 |-----------|---------|----------|--------------------------|
-| id        | integer | yes      | The ID of a project      |
-| token     | string  | yes      | The `token` of a project |
-
-### Example of request
+| `id`      | integer | yes      | The ID of a project      |
+| `token`   | string  | yes      | The `token` of a trigger |
 
 ```
 curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/triggers/7b9148c158980bbd9bcea92c17522d"
 ```
 
-### Example of response
-
 ```json
 {
     "created_at": "2015-12-23T16:25:56.760Z",
@@ -76,26 +66,20 @@ curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3
 
 ## Create a project trigger
 
-Create a trigger for a project
+Create a build trigger for a project.
 
 ```
 POST /projects/:id/triggers
 ```
 
-### Parameters
-
 | Attribute | Type    | required | Description              |
 |-----------|---------|----------|--------------------------|
-| id        | integer | yes      | The ID of a project      |
-
-### Example of request
+| `id`      | integer | yes      | The ID of a project      |
 
 ```
 curl -X POST -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/triggers"
 ```
 
-### Example of response
-
 ```json
 {
     "created_at": "2016-01-07T09:53:58.235Z",
@@ -108,20 +92,16 @@ curl -X POST -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.co
 
 ## Remove a project trigger
 
-Remove a trigger of a project
+Remove a project's build trigger.
 
 ```
 DELETE /projects/:id/triggers/:token
 ```
 
-### Parameters
-
 | Attribute | Type    | required | Description              |
 |-----------|---------|----------|--------------------------|
-| id        | integer | yes      | The ID of a project      |
-| token     | string  | yes      | The `token` of a project |
-
-### Example of request
+| `id`      | integer | yes      | The ID of a project      |
+| `token`   | string  | yes      | The `token` of a project |
 
 ```
 curl -X DELETE -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/triggers/7b9148c158980bbd9bcea92c17522d"