Skip to content

Commit 78d1b2a

Browse files
Update GitLab integration docs to mention Personal Access Tokens (#1121)
* Update settings/gitlab.mdx * copy edit and add note on tokens --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
1 parent 3eb93bd commit 78d1b2a

File tree

1 file changed

+27
-29
lines changed

1 file changed

+27
-29
lines changed

settings/gitlab.mdx

Lines changed: 27 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -4,41 +4,46 @@ description: "Sync your docs with a GitLab repo"
44
icon: "gitlab"
55
---
66

7-
We use a combination of Access tokens and Webhooks to authenticate and sync
8-
changes between GitLab and Mintlify.
7+
We use access tokens and webhooks to authenticate and sync changes between GitLab and Mintlify.
98

10-
- We use Access tokens to pull information from GitLab.
11-
- We use Webhooks so GitLab can notify Mintlify when changes are made.
12-
- This allows Mintlify to create preview deployments when a MR is created.
9+
- Mintlify uses access tokens to pull information from GitLab.
10+
- GitLab uses webhooks to notify Mintlify when changes are made, enabling preview deployments for merge requests.
1311

1412
## Set up the connection
1513

1614
<Steps>
1715
<Step title="Find your project ID">
18-
Within your GitLab project, navigate to `Settings` > `General` and find the `Project ID`.
16+
In your GitLab project, navigate to **Settings** > **General** and locate your **Project ID**.
1917
<Frame>
20-
<img src="/images/gitlab/gitlab-project-id.png" />
18+
<img src="/images/gitlab/gitlab-project-id.png" alt="The General Settings page in the GitLab dashboard. The Project ID is highlighted." />
2119
</Frame>
2220
</Step>
2321
<Step title="Generate an access token">
24-
a. Navigate to `Settings` > `Access Tokens`.
25-
26-
b. Select `Add new token`.
27-
1. Name the token "Mintlify".
28-
2. If you have a private repo, you must set the role as `Maintainer`.
29-
3. Choose `api` and `read_api` for the scopes.
30-
31-
c. Finally click `Create project access token` and copy the token.
22+
Navigate to **Settings** > **Access Tokens** and select **Add new token**.
23+
24+
Configure the token with these settings:
25+
- **Name**: Mintlify
26+
- **Role**: Maintainer (required for private repos)
27+
- **Scopes**: `api` and `read_api`
28+
29+
Click **Create project access token** and copy the token.
30+
31+
<Note>
32+
If Project Access Tokens are not available, you can use a Personal Access Token instead. Note that Personal Access Tokens expire and must be updated.
33+
</Note>
3234

3335
<Frame>
34-
<img src="/images/gitlab/gitlab-project-access-token.png" />
36+
<img src="/images/gitlab/gitlab-project-access-token.png" alt="The Access tokens page in the GitLab dashboard. The settings to configure for Mintlify are highlighted." />
3537
</Frame>
3638

3739
</Step>
3840
<Step title="Set up the connection">
39-
Within the [Mintlify dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings), add the project ID and access token from the previous steps alongside the other configurations. Click "Save Changes" when you're done.
41+
In the [Mintlify dashboard](https://dashboard.mintlify.com/settings/deployment/git-settings):
42+
1. Enter your project ID and access token.
43+
2. Complete any other required configurations.
44+
3. Click **Save Changes**.
4045
<Frame>
41-
<img src="/images/gitlab/gitlab-config.png" />
46+
<img src="/images/gitlab/gitlab-config.png" alt="The Git Settings page in the Mintlify dashboard. The GitLab configuration settings are highlighted." />
4247
</Frame>
4348
</Step>
4449
</Steps>
@@ -65,13 +70,13 @@ automatically trigger deployments.
6570
</Frame>
6671
</Step>
6772
<Step title="Select events">
68-
Select the events you want to trigger the webhook:
69-
- Push events (All branches)
70-
- Merge requests events
73+
Select these events to trigger the webhook:
74+
- **Push events** (All branches)
75+
- **Merge requests events**
7176

7277
When you're done it should look like this:
7378
<Frame>
74-
<img src="/images/gitlab/gitlab-project-webtoken.png" />
79+
<img src="/images/gitlab/gitlab-project-webtoken.png" alt="The Webhook page in the GitLab dashboard. The settings to configure for Mintlify are highlighted." />
7580
</Frame>
7681
</Step>
7782
<Step title="Test the Webhook">
@@ -84,10 +89,3 @@ automatically trigger deployments.
8489

8590
</Step>
8691
</Steps>
87-
88-
<Note>
89-
Reach out to the Mintlify team if you need help. Contact us
90-
[here](https://mintlify.com/enterprise).
91-
</Note>
92-
93-
[git-settings]: https://dashboard.mintlify.com/settings/deployment/git-settings

0 commit comments

Comments
 (0)