Add GitLab Trello Power-Up Documentation

1 files changed, 30 insertions, 0 deletions

diff --git a/doc/integration/trello_power_up.md b/doc/integration/trello_power_up.md
new file mode 100644
index 00000000000..98d24a7b249
--- /dev/null
+++ b/doc/integration/trello_power_up.md
@@ -0,0 +1,30 @@
+# Trello Power-Up
+
+GitLab's Trello Power-Up enables you to seamlessly attach GitLab merge requests to Trello cards.
+
+## Configuring the Power-Up
+
+In order to get started, you will need to configure your Power-Up.
+
+1. Go to your Trello board
+
+1. Select `Power-Ups` to see a listing of all the available Power-Ups
+
+1. Look for a row that says `GitLab` and select the `Enable` button
+
+1. Select the `Settings` (gear) icon
+
+1. In the popup menu, select `Authorize Account`
+
+In this popup, fill in your `API URL` and `Personal Access Token`. After that, you will be able to attach any merge request to any Trello card on your selected Trello board.
+
+## What is my API URL?
+
+Your API URL should be your gitlab instance URL with `/api/v4` appended in the end of the URL.
+For example, if your gitlab instance URL is `https://mygitlab.com`, your API URL would be `https://mygitlab.com/api/v4`.
+
+## What is my Personal Access Token?
+
+You can learn more about generating a personal access token in the [Personal Access Token Documentation][]
+
+[Personal Access Token Documentation]: user/profile/personal_access_tokens.html