docs(bitbucket): document native YAML AI writeback

[sdolidze]

Closes: https://linear.app/lightdash/issue/SPK-2024

Summary

PR 3 of 3 for native Bitbucket writeback. Documents connecting native Lightdash YAML through Bitbucket Cloud and using AI writeback, with token setup, project directories, validation, and provider limitations.

Companion to connection/compiler PR #28953 and AI writeback PR #28954. This lives in the documentation repository; merge after the product changes are available.

Bitbucket Cloud + Native Lightdash YAML
  → compile/refresh → AI edit → validate → pull request
  → review and merge in Bitbucket → refresh Lightdash

Updates the connection guide, native YAML guide, AI writeback, dbt write-back scope, and self-hosting prerequisites. Preserves existing section anchors and keeps native Explore custom-field writeback GitHub-only. Token permissions remain documented in the canonical connection guide.

Test plan

• Repository documentation validator: passed with zero errors; git diff whitespace check passed.
• Chrome DevTools: inspected the native connection and AI writeback pages in the local Mintlify preview.
• Setup and writeback instructions checked against the actual Bitbucket native compile, create/update PR, and warehouse-query tests performed for the two product PRs.
• Mintlify broken-links reports the same two SCIM links and duplicate IA YAML key on this branch and current main; no new link failures.

[mintlify]

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

Project	Status	Preview	Updated
lightdash	🟢 Ready	View Preview	Sep 9, 2026, 3:20 PM

[linear-code]

SPK-2024

[sdolidze]

• docs(bitbucket): document native YAML AI writeback #1233 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.