From 54faeed599940fa7b11e478296b62ef1873f9f64 Mon Sep 17 00:00:00 2001 From: Johannes Millan Date: Sat, 11 Jan 2025 14:45:24 +0100 Subject: [PATCH] docs: make token docs work better --- docs/github-access-token-instructions.md | 28 +++--------------------- docs/gitlab-access-token-instructions.md | 17 ++++++++++++++ 2 files changed, 20 insertions(+), 25 deletions(-) create mode 100644 docs/gitlab-access-token-instructions.md diff --git a/docs/github-access-token-instructions.md b/docs/github-access-token-instructions.md index 18a356af1f1..8978d81118c 100644 --- a/docs/github-access-token-instructions.md +++ b/docs/github-access-token-instructions.md @@ -1,10 +1,6 @@ -# How to generate an Access Token with Privileges +# How to generate a GitHub Access Token with Privileges -## GitHub - -### GitHub Personal Access Token - -To generate a GitHub Personal Access Token (for GitLab see below): +To generate a GitHub Personal Access Token: 1. Navigate to GitHub's [Personal Access Tokens (Classic)](https://github.com/settings/tokens) page - Note: Fine-grained tokens are not currently supported @@ -12,22 +8,4 @@ To generate a GitHub Personal Access Token (for GitLab see below): 3. Select the `repo` scope to grant access to private repositories 4. Click "Generate token" and securely store the token value - -## GitLab - -### GitLab Personal Access Token -For polling GitLab Issues, you need to provide an access token. - -1. Go to User Settings / Access tokens -2. Add a new token with the scope `api` - -![Personal Token](https://github.com/user-attachments/assets/76fb204e-450a-4516-9d93-897ae2a32f6d) - - -### GitLab Project Access Token -If you self-host GitLab or have the Premium/Ultimate license, it's possible to get a Project Access Token, which is scoped to a project. -The scope is similar to the Personal Access token, but you also set a role. To learn what each role can do, see the Documentation. - - -![Project Token](https://github.com/user-attachments/assets/f008f114-3d3e-450d-9301-7825222f9812) - +[=> for GitLab Access Token go here](./gitlab-access-token-instructions.md) diff --git a/docs/gitlab-access-token-instructions.md b/docs/gitlab-access-token-instructions.md new file mode 100644 index 00000000000..45164354d62 --- /dev/null +++ b/docs/gitlab-access-token-instructions.md @@ -0,0 +1,17 @@ +# How to generate an Access Token with Privileges + +## GitLab Personal Access Token + +For polling GitLab Issues, you need to provide an access token. + +1. Go to User Settings / Access tokens +2. Add a new token with the scope `api` + +![Personal Token](https://github.com/user-attachments/assets/76fb204e-450a-4516-9d93-897ae2a32f6d) + +## GitLab Project Access Token + +If you self-host GitLab or have the Premium/Ultimate license, it's possible to get a Project Access Token, which is scoped to a project. +The scope is similar to the Personal Access token, but you also set a role. To learn what each role can do, see the Documentation. + +![Project Token](https://github.com/user-attachments/assets/f008f114-3d3e-450d-9301-7825222f9812)