Skip to content

feat: add bitbucket developer docs#295

Open
Saurabhkmr98 wants to merge 1 commit into
masterfrom
feat/bitbucket-docs
Open

feat: add bitbucket developer docs#295
Saurabhkmr98 wants to merge 1 commit into
masterfrom
feat/bitbucket-docs

Conversation

@Saurabhkmr98

@Saurabhkmr98 Saurabhkmr98 commented Jun 22, 2026

Copy link
Copy Markdown
Member

Description

  • Added Bitbucket app creation docs

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

Summary by CodeRabbit

  • Documentation
    • Added comprehensive guide for Bitbucket integration setup
    • Covers configuration steps for both Bitbucket Cloud and Bitbucket Data Center
    • Includes OAuth consumer creation, environment variable configuration, and integration activation instructions

@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Jun 22, 2026 3:01pm

Request Review

@coderabbitai

coderabbitai Bot commented Jun 22, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

A new documentation page for the Bitbucket self-hosting integration is added, covering setup for both Bitbucket Cloud and Bitbucket Data Center. A matching sidebar navigation entry is registered in the VitePress config under the Integrations section.

Changes

Bitbucket Integration Documentation

Layer / File(s) Summary
Bitbucket integration guide and sidebar entry
docs/self-hosting/govern/integrations/bitbucket.md, docs/.vitepress/config.mts
New 123-line guide covering OAuth consumer creation for Bitbucket Cloud, application link creation for Bitbucket Data Center, required .env variables (CLIENT_ID, CLIENT_SECRET, WEBHOOK_SECRET), and activation steps. The sidebar entry Bitbucket linking to /self-hosting/govern/integrations/bitbucket is inserted before the existing GitHub entry.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

A bunny hops in, ears perked up with glee,
A Bitbucket page now lives, plain as can be!
Cloud or Data Center, pick your own trail,
OAuth or app links — neither will fail.
🐇 Hop on and integrate, don't be a snail!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat: add bitbucket developer docs' accurately summarizes the main change in the pull request, which is adding new Bitbucket integration documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/bitbucket-docs

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/self-hosting/govern/integrations/bitbucket.md`:
- Line 38: The document uses h4 headings (####) that skip the h3 level,
violating the heading-increment lint rule which requires headings to increment
by only one level at a time. Change all h4 headings (####) to h3 headings (###)
to maintain proper hierarchy between the surrounding h2 sections (##). This
includes the "Bitbucket Cloud" heading and the heading on line 75 mentioned in
the comment, and any other similar h4 headings in the document that jump
directly from h2 sections.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3a3562ba-ba88-4a88-b71e-219bc2d7e7c8

📥 Commits

Reviewing files that changed from the base of the PR and between f6749a7 and 6c65cae.

📒 Files selected for processing (2)
  • docs/.vitepress/config.mts
  • docs/self-hosting/govern/integrations/bitbucket.md


Follow these steps to register an OAuth consumer in your Bitbucket workspace, set the callback URL and scopes, and then configure your Plane instance so it can sync pull requests and commits.

#### Bitbucket Cloud

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Use h3 headings here.

These #### headings jump too far from the surrounding ## sections and will fail the heading-increment lint rule. Drop them to ### (or remove the duplicate headings and rely on the tab labels).

Suggested fix
-#### Bitbucket Cloud
+### Bitbucket Cloud
@@
-#### Bitbucket Data Center
+### Bitbucket Data Center

Also applies to: 75-75

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 38-38: 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 current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/self-hosting/govern/integrations/bitbucket.md` at line 38, The document
uses h4 headings (####) that skip the h3 level, violating the heading-increment
lint rule which requires headings to increment by only one level at a time.
Change all h4 headings (####) to h3 headings (###) to maintain proper hierarchy
between the surrounding h2 sections (##). This includes the "Bitbucket Cloud"
heading and the heading on line 75 mentioned in the comment, and any other
similar h4 headings in the document that jump directly from h2 sections.

Source: Linters/SAST tools

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.

1 participant