docs: make token docs work better

This commit is contained in:
Johannes Millan 2025-01-11 14:45:24 +01:00
parent 102556af79
commit 54faeed599
2 changed files with 20 additions and 25 deletions

View file

@ -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 <a href="https://docs.gitlab.com/ee/user/permissions.html#project-planning">Documentation</a>.
![Project Token](https://github.com/user-attachments/assets/f008f114-3d3e-450d-9301-7825222f9812)
[=> for GitLab Access Token go here](./gitlab-access-token-instructions.md)

View file

@ -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 <a href="https://docs.gitlab.com/ee/user/permissions.html#project-planning">Documentation</a>.
![Project Token](https://github.com/user-attachments/assets/f008f114-3d3e-450d-9301-7825222f9812)