docs: add Bitrise for Jira app setup guide - #141
Open
zoltan-baba wants to merge 6 commits into
Open
Conversation
Documents installing the app, creating a Bitrise API token, connecting projects, verifying the connection, and troubleshooting, based on the draft from RD Confluence and confirmed permission requirements (TW-1795). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
zoltan-baba
requested review from
aorcsik,
ilanazholobovsky and
matenadasdi
as code owners
July 23, 2026 15:52
zoltan-baba
marked this pull request as draft
July 23, 2026 15:54
The page belongs alongside other build-status-in-third-party-tool docs (e.g. Bitrise Checks on GitHub) rather than under Integrations. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The NT no-translate component only exists on ja-localization-full, which hasn't merged to main yet, so this branch's build failed with "Module not found: Can't resolve '@site/src/components/NT'". Strip the tagging for now; re-add once that branch lands. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Requested by Jeremy Palmer (warning added to the Confluence draft on Jul 27): the app supports Jira Cloud only, not self-hosted Jira (Data Center/Server). Placed at the top of the page per his note. The draft's "may introduce this capability in future" line intentionally omitted - docs don't promise roadmap.
Verified against the live UI (Technical Writing workspace, 2026-07-29): - "Workspace Role" -> "Workspace role" (UI uses lowercase) - "Configure Access to Products" -> "Configure access to products" (sentence case in UI) - Dropped "or higher" for the token's Bitrise CI role - the wizard's Role dropdown only offers No access / Platform Engineer / Developer / Tester/QA - "before closing the dialog" -> "before leaving the Save token step" - token creation is a 3-step wizard, not a dialog Follow-up filed for the canonical Workspace API token page: TW-1803.
ilanazholobovsky
marked this pull request as ready for review
July 29, 2026 13:54
ilanazholobovsky
previously approved these changes
Jul 29, 2026
ilanazholobovsky
left a comment
ilanazholobovsky
left a comment
Collaborator
There was a problem hiding this comment.
Added Jeremy's Jira Cloud only note + aligned token wording with the live Create token wizard — verified in-product today. Approving.
Replace the TODO placeholder with screenshots of the Bitrise builds section and the Builds tab of Jira's development panel. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
change_settingsand build rerun/abort'srun_builds) confirmed againstbitrise-websitesource and product engineering — see TW-1795 for details.Test plan
node scripts/check-links-source.js docs/bitrise-platform/integrations/bitrise-for-jira-app.mdxpasses clean