Add Gitlab documentation

3 files changed, 62 insertions, 4 deletions

diff --git a/README.markdown b/README.markdown
index 603f4c5b..e83e8543 100644
--- a/README.markdown
+++ b/README.markdown
@@ -76,6 +76,11 @@ Documentation
 - [Application settings](docs/application-configuration.markdown)
 - [Board settings](docs/board-configuration.markdown)
 
+### Integrations
+
+- [Github webhooks](docs/github-webhooks.markdown)
+- [Gitlab webhooks](docs/gitlab-webhooks.markdown)
+
 #### More
 
 - [Syntax guide](docs/syntax-guide.markdown)
@@ -107,10 +112,6 @@ Documentation
 - [GitHub authentication](docs/github-authentication.markdown)
 - [Reverse proxy authentication](docs/reverse-proxy-authentication.markdown)
 
-### Integration
-
-- [Github webhooks](docs/github-webhooks.markdown)
-
 #### Developers and sysadmins
 
 - [Email configuration](docs/email-configuration.markdown)
diff --git a/docs/github-webhooks.markdown b/docs/github-webhooks.markdown
index 30863d27..e158c46b 100644
--- a/docs/github-webhooks.markdown
+++ b/docs/github-webhooks.markdown
@@ -25,6 +25,8 @@ List of available actions
 - Change the assignee based on an external username
 - Change the category based on an external label
 - Create a comment from an external provider
+- Close a task
+- Open a task
 
 Configuration on Github
 -----------------------
diff --git a/docs/gitlab-webhooks.markdown b/docs/gitlab-webhooks.markdown
new file mode 100644
index 00000000..ae49b914
--- /dev/null
+++ b/docs/gitlab-webhooks.markdown
@@ -0,0 +1,55 @@
+Gitlab webhooks
+===============
+
+Gitlab events can be connected to Kanboard automatic actions.
+
+List of supported events
+------------------------
+
+- Gitlab commit received
+- Gitlab issue opened
+- Gitlab issue closed
+
+List of supported actions
+-------------------------
+
+- Create a task from an external provider
+- Close a task
+
+Configuration
+-------------
+
+[INSERT SCREENSHOT]
+
+1. On Kanboard, go to the project settings and choose the section **Integrations**
+2. Copy the Gitlab webhook url
+3. On Gitlab, go to the project settings and go the section **Webhooks**
+4. Check the boxes **Push Events** and **Issues Events**
+5. Paste the url and save
+
+Examples
+--------
+
+### Close a Kanboard task when a commit pushed to Gitlab
+
+- Choose the event: **Gitlab commit received**
+- Choose the action: **Close the task**
+
+When one or more commits are sent to Gitlab, Kanboard will receive the information, each commit message with a task number included will be closed.
+
+Example:
+
+- Commit message: "Fix bug #1234"
+- That will close the Kanboard task #1234
+
+### Create a Kanboard task when a new issue is opened on Gitlab
+
+- Choose the event: **Gitlab issue opened**
+- Choose the action: **Create a task from an external provider**
+
+When a task is created from a Gitlab issue, the link to the issue is added to the description and the task have a new field named "Reference" (this is the Gitlab ticket number).
+
+### Close a Kanboard task when an issue is closed on Gitlab
+
+- Choose the event: **Gitlab issue closed**
+- Choose the action: **Close the task**