Skip to content

SEO fixes for integrations page#229

Merged
sriramveeraghanta merged 3 commits intomasterfrom
improve-integration-seo
Mar 2, 2026
Merged

SEO fixes for integrations page#229
sriramveeraghanta merged 3 commits intomasterfrom
improve-integration-seo

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Mar 2, 2026

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

References

Summary by CodeRabbit

  • Documentation
    • Enhanced GitHub integration guide with expanded instructions for GitHub Cloud and Enterprise Server setups, covering callback URLs, webhook configuration, and app creation.
    • Improved GitLab integration documentation with separate guidance for Cloud and Self-managed deployments, including OAuth app registration and required scope information.

@vercel
Copy link

vercel bot commented Mar 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Mar 2, 2026 1:15pm

Request Review

@coderabbitai
Copy link

coderabbitai bot commented Mar 2, 2026

Warning

Rate limit exceeded

@danciaclara has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 24 minutes and 45 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 4ca8507 and e50a5d2.

📒 Files selected for processing (2)
  • docs/self-hosting/govern/integrations/github.md
  • docs/self-hosting/govern/integrations/gitlab.md
📝 Walkthrough

Walkthrough

Documentation updates for GitHub and GitLab integration guides, introducing platform-specific subsections for Cloud and on-premises deployments. Keywords metadata refined and introductory guidance paragraphs added to clarify setup distinctions between each platform variant.

Changes

Cohort / File(s) Summary
GitHub Integration Documentation
docs/self-hosting/govern/integrations/github.md
Added subsection headers for GitHub Cloud and GitHub Enterprise Server with platform-specific introductory guidance covering app creation, callbacks, webhooks, and on-prem hostname configuration. Updated keywords metadata.
GitLab Integration Documentation
docs/self-hosting/govern/integrations/gitlab.md
Added subsection headers for GitLab Cloud and GitLab Self-managed with OAuth app registration and scopes guidance. Updated keywords metadata to include gitlab.com and gitlab self-managed variants.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A rabbit hops through docs so clear,
With GitHub and GitLab sections dear,
Cloud and on-prem now separate ways,
Integration guides shine brighter these days! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'SEO fixes for integrations page' accurately reflects the main changes, which focus on updating documentation metadata (keywords) and adding introductory guidance to GitHub and GitLab integration pages.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch improve-integration-seo

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/self-hosting/govern/integrations/github.md`:
- Around line 39-42: The markdown uses a deeper heading level (####) for "GitHub
Cloud" and the enterprise subsection which breaks the heading hierarchy and
triggers MD001; update the heading tokens for the "GitHub Cloud" and the
enterprise subsection headings from '####' to '###' so they consistently sit
under the parent section and avoid heading increment warnings.
- Line 4: The frontmatter `keywords` entry has a trailing comma/space causing
Prettier to fail; edit the YAML frontmatter in
docs/self-hosting/govern/integrations/github.md and remove the trailing
comma/space from the `keywords:` value (or convert it to a proper YAML list) so
the `keywords` line no longer ends with ", " and conforms to the project's
Prettier rules; ensure the `keywords` key is a valid comma-separated string or
list without a trailing comma.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b5bf55b and 4ca8507.

📒 Files selected for processing (2)
  • docs/self-hosting/govern/integrations/github.md
  • docs/self-hosting/govern/integrations/gitlab.md

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,
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Fix frontmatter keywords formatting to unblock CI.

Line 4 has a trailing comma/space in keywords, which is consistent with the reported Prettier failure.

Proposed fix
-keywords: plane github integration, github cloud, github enterprise, github sync, pull request tracking, commit linking, github app, 
+keywords: plane github integration, github cloud, github enterprise, github sync, pull request tracking, commit linking, github app

As per coding guidelines, "**/*.{ts,tsx,js,jsx,vue,json,md,mts}: Prettier formatting checks must pass in CI, with 120 character line width, 2-space indent, semicolons, double quotes, and ES5 trailing commas".

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
keywords: plane github integration, github cloud, github enterprise, github sync, pull request tracking, commit linking, github app,
keywords: plane github integration, github cloud, github enterprise, github sync, pull request tracking, commit linking, github app
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/govern/integrations/github.md` at line 4, The frontmatter
`keywords` entry has a trailing comma/space causing Prettier to fail; edit the
YAML frontmatter in docs/self-hosting/govern/integrations/github.md and remove
the trailing comma/space from the `keywords:` value (or convert it to a proper
YAML list) so the `keywords` line no longer ends with ", " and conforms to the
project's Prettier rules; ensure the `keywords` key is a valid comma-separated
string or list without a trailing comma.

Comment on lines +39 to +42
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

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Use consistent heading depth under section context.

Line 39 (#### GitHub Cloud) jumps heading depth and triggers MD001. The same pattern appears at Line 85 for the enterprise subsection. Use ### to avoid heading increment warnings.

Proposed fix
-#### GitHub Cloud
+### GitHub Cloud
...
-#### GitHub Enterprise Server
+### GitHub Enterprise Server

Also applies to: 85-86

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 39-39: Heading levels should only increment by one level at a time
Expected: h3; Actual: h4

(MD001, heading-increment)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/govern/integrations/github.md` around lines 39 - 42, The
markdown uses a deeper heading level (####) for "GitHub Cloud" and the
enterprise subsection which breaks the heading hierarchy and triggers MD001;
update the heading tokens for the "GitHub Cloud" and the enterprise subsection
headings from '####' to '###' so they consistently sit under the parent section
and avoid heading increment warnings.

@sriramveeraghanta sriramveeraghanta merged commit 2cfc0e4 into master Mar 2, 2026
5 checks passed
@sriramveeraghanta sriramveeraghanta deleted the improve-integration-seo branch March 2, 2026 14:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants