summaryrefslogtreecommitdiff
path: root/doc/development/dangerbot.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/development/dangerbot.md')
-rw-r--r--doc/development/dangerbot.md14
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/development/dangerbot.md b/doc/development/dangerbot.md
index 8f5788785f0..d9b922cb60e 100644
--- a/doc/development/dangerbot.md
+++ b/doc/development/dangerbot.md
@@ -151,12 +151,16 @@ at GitLab so far:
Danger is run but its output is not added to a merge request comment if working
on a fork. This happens because the secret variable from the canonical project
-is not shared to forks. To work around this, you can add an [environment
-variable](../ci/variables/index.md) called `DANGER_GITLAB_API_TOKEN` with a
+is not shared to forks.
+
+### Configuring Danger for forks
+
+Contributors can configure Danger for their forks with the following steps:
+
+1. Add an [environment variable](../ci/variables/index.md) called `DANGER_GITLAB_API_TOKEN` with a
[personal API token](https://gitlab.com/-/profile/personal_access_tokens?name=GitLab+Dangerbot&scopes=api)
-to your fork that has the `api` scope set. That way the danger comments are made
-from CI using that API token instead. Making the variable
-[masked](../ci/variables/index.md#mask-a-cicd-variable) makes sure it
+to your fork that has the `api` scope set.
+1. Making the variable [masked](../ci/variables/index.md#mask-a-cicd-variable) makes sure it
doesn't show up in the job logs. The variable cannot be
[protected](../ci/variables/index.md#protect-a-cicd-variable), as it needs
to be present for all feature branches.