Skip to content

BP-2638: Jira integration#321

Merged
jeff-matthews merged 4 commits into
mainfrom
BP-2638-jira-forge
Jul 9, 2026
Merged

BP-2638: Jira integration#321
jeff-matthews merged 4 commits into
mainfrom
BP-2638-jira-forge

Conversation

@jeff-matthews

@jeff-matthews jeff-matthews commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • Documentation
    • Added a new Atlassian (Jira) integration documentation section, including dedicated pages for configure, use, troubleshoot, and reference.
    • Documented end-to-end guidance for connecting Jira Cloud, setting sync and remediation tracking behavior, verifying results, and resolving common setup issues.
    • Updated the integrations overview page with improved Google SecOps wording and a (currently non-rendering) Jira card insertion.

Staging

@jeff-matthews jeff-matthews self-assigned this Jun 23, 2026
@jeff-matthews jeff-matthews added the integrations Docs related to integrations with third-party platforms label Jun 23, 2026
@mintlify

mintlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
bloodhound 🟢 Ready View Preview Jun 23, 2026, 6:29 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 44f6cd91-94c0-4b85-9f74-b78149526303

📥 Commits

Reviewing files that changed from the base of the PR and between 9c1d46e and 4b83547.

📒 Files selected for processing (5)
  • docs/integrations/atlassian/jira/configure.mdx
  • docs/integrations/atlassian/jira/reference.mdx
  • docs/integrations/atlassian/jira/troubleshoot.mdx
  • docs/integrations/atlassian/jira/use.mdx
  • docs/integrations/overview.mdx
✅ Files skipped from review due to trivial changes (5)
  • docs/integrations/overview.mdx
  • docs/integrations/atlassian/jira/use.mdx
  • docs/integrations/atlassian/jira/troubleshoot.mdx
  • docs/integrations/atlassian/jira/reference.mdx
  • docs/integrations/atlassian/jira/configure.mdx

Walkthrough

Adds Jira integration documentation pages for configure, use, troubleshoot, and reference. Registers the Jira integration in navigation and adds a Jira card entry to the integrations overview page.

Changes

Jira Integration Documentation

Layer / File(s) Summary
Navigation registration and integrations overview card
docs/docs.json, docs/integrations/overview.mdx
Inserts the Atlassian/Jira navigation group into the API & Integrations tab and adds a Jira integration card block to the integrations overview page with updated Google SecOps wording.
Configure page: installation, connection, and sync settings
docs/integrations/atlassian/jira/configure.mdx
Adds the configure page with prerequisites, Marketplace installation steps, connection setup, synchronization settings, auto-closure behavior, and post-sync verification links.
Use page: issue model, format, sync behavior, and workflows
docs/integrations/atlassian/jira/use.mdx
Adds the use page covering the Jira issue model, issue format, synchronization cadence, duplicate prevention, cleanup behavior, and review workflows.
Troubleshoot page: failure scenarios and error messages
docs/integrations/atlassian/jira/troubleshoot.mdx
Adds troubleshooting sections for connection test failures, locked configuration, missing issue creation, incorrect mappings, auto-closure behavior, missing JSM request types, and common configuration messages.
Reference page: architecture, auth, sync model, and API dependencies
docs/integrations/atlassian/jira/reference.mdx
Adds the reference page covering the Forge-based architecture, authentication and secrets handling, configuration inputs, Jira Software versus Jira Service Management behavior, sync and cleanup cadence, issue content fields, BHE API dependencies, error handling, and external platform dependencies.

Estimated code review effort: 2 (Simple) | ~20 minutes

Suggested reviewers: slokie-so, zaton-netizen

Poem

🐇 I hopped through docs from start to end,
Jira and BHE now link and blend.
Configure, use, troubleshoot, reference—hooray,
The mapping guide is ready today.
A tidy little burrow of pages shines bright,
With syncs and remediations tucked in just right.

🚥 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 clearly identifies the Jira integration docs addition and is concise.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch BP-2638-jira-forge

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (2)
docs/integrations/atlassian/jira/troubleshoot.mdx (1)

53-62: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Optional style improvement: Consider more formal verb phrasing.

Line 57 uses "To correct the issue." For consistency with formal documentation tone, consider rephrasing to "To resolve the issue" or "To fix the issue," which may align better with the broader documentation style.

🤖 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/integrations/atlassian/jira/troubleshoot.mdx` around lines 53 - 62, The
introductory phrase "To correct the issue" uses informal language that doesn't
align with formal documentation tone. Replace "To correct the issue" with "To
resolve the issue" or "To fix the issue" in the troubleshooting section for the
"Jira uses the wrong priority or due date" heading to maintain consistency with
the broader documentation style guide.

Source: Linters/SAST tools

docs/integrations/atlassian/jira/reference.mdx (1)

144-144: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Minor wording improvement on line 144.

"The integration calls for centralized API error handling" is awkward phrasing. Consider: "The integration implements centralized API error handling" or "uses centralized API error handling."

🤖 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/integrations/atlassian/jira/reference.mdx` at line 144, The phrase
"calls for centralized API error handling" on line 144 is awkward phrasing.
Replace "calls for" with a more direct verb such as "implements" or "uses" to
improve clarity. The sentence should read "The integration implements
centralized API error handling with logging and graceful recovery when possible"
or similar variation.
🤖 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/integrations/overview.mdx`:
- Around line 90-93: The Jira Card component has an incorrect href attribute
that points to `/integrations/jira/forge/configure` instead of the correct
registered docs path. Update the href attribute in the Card component with
title="Jira" to use `/integrations/atlassian/jira/configure` to match the
correct documentation path already used elsewhere in the file and ensure the
link target is consistent and functional.

---

Nitpick comments:
In `@docs/integrations/atlassian/jira/reference.mdx`:
- Line 144: The phrase "calls for centralized API error handling" on line 144 is
awkward phrasing. Replace "calls for" with a more direct verb such as
"implements" or "uses" to improve clarity. The sentence should read "The
integration implements centralized API error handling with logging and graceful
recovery when possible" or similar variation.

In `@docs/integrations/atlassian/jira/troubleshoot.mdx`:
- Around line 53-62: The introductory phrase "To correct the issue" uses
informal language that doesn't align with formal documentation tone. Replace "To
correct the issue" with "To resolve the issue" or "To fix the issue" in the
troubleshooting section for the "Jira uses the wrong priority or due date"
heading to maintain consistency with the broader documentation style guide.
🪄 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9609f5de-6030-4ee8-abb3-da8ae9d1ff37

📥 Commits

Reviewing files that changed from the base of the PR and between 10103aa and 9c1d46e.

📒 Files selected for processing (6)
  • docs/docs.json
  • docs/integrations/atlassian/jira/configure.mdx
  • docs/integrations/atlassian/jira/reference.mdx
  • docs/integrations/atlassian/jira/troubleshoot.mdx
  • docs/integrations/atlassian/jira/use.mdx
  • docs/integrations/overview.mdx

Comment thread docs/integrations/overview.mdx Outdated

@zaton-netizen zaton-netizen 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.

Good to ship

@jeff-matthews jeff-matthews merged commit 68ffa14 into main Jul 9, 2026
3 checks passed
@jeff-matthews jeff-matthews deleted the BP-2638-jira-forge branch July 9, 2026 14:20
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

integrations Docs related to integrations with third-party platforms

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants