Merge branch 'kwiebers-master-patch-31780' into 'master'

Improve the documentation for Danger from forks

See merge request gitlab-org/gitlab!67066

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.