From 1f9ab89d79348386a733e21122757d83dccf4552 Mon Sep 17 00:00:00 2001 From: Clement Ho Date: Thu, 20 Jul 2017 10:29:42 -0500 Subject: Add GitLab Trello Power-Up Documentation --- doc/README.md | 1 + doc/integration/trello_power_up.md | 30 ++++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 doc/integration/trello_power_up.md (limited to 'doc') diff --git a/doc/README.md b/doc/README.md index 1a7638b3d7e..2b3b0998fcc 100644 --- a/doc/README.md +++ b/doc/README.md @@ -115,6 +115,7 @@ Manage files and branches from the UI (user interface): - [Project Services](user/project/integrations/project_services.md): Integrate a project with external services, such as CI and chat. - [GitLab Integration](integration/README.md): Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication. +- [Trello Power-Up](integration/trello_power_up.md): Integrate with GitLab's Trello Power-Up ---- 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 -- cgit v1.2.1