[claudiacodacy]

Bitbucket users see Atlassian's permissions page every time they log in to Codacy, not only the first time. The investigation on OD-576 reproduced this with a brand-new Bitbucket OAuth consumer and no Codacy code: Atlassian moved Bitbucket OAuth consumers onto its 3LO platform, which shows consent on every authorization. Codacy can't turn it off.

This adds a troubleshooting page that explains the prompt and tells affected users how to report it to Atlassian, so support and the upcoming in-app note (OD-990) have one page to point to. Requested in OD-989.

What changed

• New docs/faq/troubleshooting/why-does-bitbucket-ask-me-to-grant-codacy-access-every-time-i-log-in.md. It's a troubleshooting page modeled on why-cant-i-see-my-organization.md, covering what the prompt is, why it happens, and two steps: accept the permissions, and let Atlassian know it affects your team (reply on the public Atlassian Developer Community thread, or contact Atlassian Support).
• mkdocs.yml: the page is added to the FAQ → Troubleshooting nav. No redirect is needed because the page is new.
• docs/faq/general/how-does-codacy-support-bitbucket-cloud.md: one new bullet under Limitations, linking to the new page.

Atlassian request

• Codacy reported this to Atlassian Support as request BBS-257159. The page names it as plain text, not a link, because the request is private: customers can't open it, but Atlassian Support can match their reports to it.
• There's no public Atlassian issue (BCLOUD) to vote on yet, so the page links to the public community thread. If Atlassian opens a public issue, link it here.

Not covered

• The 90-day refresh-token expiry Atlassian announced is left out. What a Codacy user sees when it happens isn't confirmed yet.

Checks

• mkdocs build --strict passes, the page appears in the nav, and both new internal links resolve.
• Vale: 0 errors, 0 warnings, 0 suggestions on both changed pages.
• No headings renamed, and no includes or lockstep siblings involved.

👀 Live preview

🚧 To do

• If relevant, include the Jira issue key at the end of the pull request title
• Perform a self-review of the changes
• Fix any issues reported by the CI/CD

🤖 Generated with Claude Code

[github-actions]

Overall readability score: 54.55 (🟢 +0.07)

File	Readability
why-does-bitbucket-ask-me-to-grant-codacy-access-every-time-i-log-in.md	69.13 (-)
how-does-codacy-support-bitbucket-cloud.md	60.12 (🟢 +5.46)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
why-does-bitbucket-ask-me-to-grant-codacy-access-every-time-i-log-in.md	69.13	49.92	7.88	9.8	11.47	6.81
	-	-	-	-	-	-
how-does-codacy-support-bitbucket-cloud.md	60.12	38.21	9.72	11.5	12.47	6.82
	🟢 +5.46	🟢 +8.76	🟢 +0.49	🟢 +0.8	🟢 +0.81	🟢 +0.27

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	54.55	43.29	10.85	12.28	12.23	7.97
	🟢 +0.07	🟢 +0.06	🟢 +0.01	🟢 +0.01	🟢 +0.01	🟢 +0.01

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

_{TIP This summary will be updated as you push new changes.}

[codacy-production]

Pull Request Overview

✅ No blocking issues noticed

No blocking findings were identified. The required automated documentation check remains missing.

Test suggestions

• Verify the new limitation renders in the Bitbucket Cloud FAQ and the permissions link resolves to the Bitbucket Cloud section.

Prompt proposal for missing tests

Consider implementing these tests if applicable:
1. Verify the new limitation renders in the Bitbucket Cloud FAQ and the permissions link resolves to the Bitbucket Cloud section.

_{TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback}