diff --git a/docs/self-hosting/govern/integrations/github.md b/docs/self-hosting/govern/integrations/github.md
index 82d3549..974f77d 100644
--- a/docs/self-hosting/govern/integrations/github.md
+++ b/docs/self-hosting/govern/integrations/github.md
@@ -1,7 +1,7 @@
 ---
 title: Configure GitHub for Plane integration
 description: Connect GitHub to your self-hosted Plane instance. Sync pull requests, commits, and branches with Plane work items for seamless development tracking.
-keywords: plane github integration, github sync, pull request tracking, commit linking, github app, self-hosting, plane devops
+keywords: plane github integration, github cloud, github enterprise, github sync, pull request tracking, commit linking, github app,
 ---
 
 # Configure GitHub for Plane integration <Badge type="info" text="Pro" />
@@ -36,6 +36,10 @@ To configure GitHub integration, you'll need to create a GitHub App within your
 
 == GitHub Cloud {#github-cloud}
 
+Follow these steps to create a GitHub App, set callback URLs, and configure webhooks so Plane can sync PRs and commits from GitHub Cloud.
+
+#### GitHub Cloud
+
 1. Go to **Settings \> Developer Settings \> GitHub Apps** in your GitHub organization.
 
 2. Click **New GitHub App**.
@@ -76,6 +80,9 @@ To configure GitHub integration, you'll need to create a GitHub App within your
    ![Add Webhook URL](/images/integrations/github/add-webhook-url.webp)
 
 == GitHub Enterprise Server {#github-enterprise-server}
+These steps cover hostname, callback URLs, and private key differences for on‑prem GitHub deployments.
+
+#### GitHub Enterprise Server
 
 1. Go to **Settings \> Developer Settings \> GitHub Apps** in your GitHub organization.
 
diff --git a/docs/self-hosting/govern/integrations/gitlab.md b/docs/self-hosting/govern/integrations/gitlab.md
index 5bbcdf6..85b95c0 100644
--- a/docs/self-hosting/govern/integrations/gitlab.md
+++ b/docs/self-hosting/govern/integrations/gitlab.md
@@ -1,7 +1,7 @@
 ---
 title: Configure GitLab for Plane integration
 description: Connect GitLab to your self-hosted Plane instance. Sync merge requests and commits with Plane work items for development workflow tracking.
-keywords: plane gitlab integration, gitlab sync, merge request tracking, gitlab webhook, self-hosting, plane devops
+keywords: plane gitlab integration, gitlab cloud, gitlab self-managed, gitlab sync, merge request tracking
 ---
 
 # Configure GitLab for Plane integration <Badge type="info" text="Pro" />
@@ -33,6 +33,11 @@ After creating and configuring the GitLab application and configuring the instan
 
 == GitLab Cloud {#gitlab-cloud}
 
+Follow these steps to register an application on the public GitLab service, set the redirect URI and scopes,
+and then configure your Plane instance so it can sync merge requests and commits.
+
+#### GitLab Cloud
+
 1. On the left sidebar in GitLab, select your avatar.
 
 2. Select **Preferences** tab.
@@ -67,6 +72,10 @@ After creating and configuring the GitLab application and configuring the instan
 
 == GitLab Self-managed {#gitlab-self-managed}
 
+These instructions cover registering an OAuth app on your private GitLab server, using the correct callback URLs, and assigning the required scopes for Plane to access your repos and users.
+
+#### GitLab Self-managed
+
 1. Log in to your GitLab instance.
 2. Click on your profile icon in the top-right corner.
 3. From the dropdown menu that appears, select **Edit profile**.