From 84c96b4502ea908b98d2fd0272cff4d3d665b587 Mon Sep 17 00:00:00 2001 From: Marcia Ramos Date: Thu, 20 Jul 2017 19:24:23 -0300 Subject: [PATCH] review troll powerup doc --- doc/integration/trello_power_up.md | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/doc/integration/trello_power_up.md b/doc/integration/trello_power_up.md index 816a1595472..d0d9ce16c6c 100644 --- a/doc/integration/trello_power_up.md +++ b/doc/integration/trello_power_up.md @@ -1,30 +1,38 @@ # Trello Power-Up -GitLab's Trello Power-Up enables you to seamlessly attach GitLab merge requests to Trello cards. +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. +In Trello: + 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`. +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://gitlab.com`, your API URL would be `https://gitlab.com/api/v4`. +If your instance's URL is `https://example.com`, your API URL will be `https://example.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]. Don't forget to check the API scope checkbox. +Your GitLab's personal access token will enable your GitLab account to be accessed +from Trello. + +> Find it in GitLab by clicking on your avatar (upright corner), from which you access +your user **Settings** > **Access Tokens**. + +Learn more about generating a personal access token in the +[Personal Access Token Documentation][personal-access-token-documentation]. +Don't forget to check the API scope checkbox! [personal-access-token-documentation]: ../user/profile/personal_access_tokens.html