docs: restore lost Bitbucket content and fix configure-scope.md for clean merge with main

Co-authored-by: ewega <26189114+ewega@users.noreply.github.com>

Author: Copilot

docs/configure-scope.md

@@ -32,12 +32,12 @@ gh devlake configure scope add [flags]
 
 | Flag | Default | Description |
 |------|---------|-------------|
-| `--plugin` | *(interactive or required)* | Plugin slug: `github`, `gh-copilot`, `jenkins`, `gitlab`, `bitbucket`, `jira`, `sonarqube`, `azuredevops_go` (alias `azure-devops`) |
+| `--plugin` | *(interactive or required)* | Plugin slug: `github`, `gitlab`, `bitbucket`, `gh-copilot`, `jenkins`, `jira`, `sonarqube`, `azuredevops_go` (alias `azure-devops`) |
 | `--connection-id` | *(auto-detected)* | Override the connection ID to scope |
-| `--org` | *(plugin-dependent)* | Organization identifier. For GitHub/Copilot: GitHub org slug. For GitLab: group path. For Azure DevOps: organization name (required). |
-| `--enterprise` | | Enterprise slug (enables enterprise-level Copilot metrics) |
-| `--repos` | | Comma-separated repos to add (`owner/repo,owner/repo2`) |
-| `--repos-file` | | Path to a file with repos (one `owner/repo` per line) |
+| `--org` | *(plugin-dependent)* | Org/workspace slug (`github`, `gitlab` group path, `bitbucket` workspace, `azuredevops_go` org). Required for plugins whose connection definition needs an org (for example, Azure DevOps) or when running non-interactively; optional in interactive mode for plugins that support workspace discovery (for example, Bitbucket). |
+| `--enterprise` | | Enterprise slug (enables enterprise-level Copilot metrics) |
+| `--repos` | | Comma-separated repos to add (`owner/repo` for GitHub, `group/project` for GitLab, `workspace/repo-slug` for Bitbucket) |
+| `--repos-file` | | Path to a file with repos (one per line: `owner/repo` for GitHub, `group/project` for GitLab, `workspace/repo-slug` for Bitbucket) |
 | `--jobs` | | Comma-separated Jenkins job full names |
 | `--deployment-pattern` | `(?i)deploy` | Regex matching CI/CD workflow names for deployments |
 | `--production-pattern` | `(?i)prod` | Regex matching environment names for production |
@@ -83,6 +83,9 @@ gh devlake configure scope add --plugin github --org my-org \
 # Interactive repo selection (omit --repos)
 gh devlake configure scope add --plugin github --org my-org
 
+# Bitbucket repos (interactive remote-scope picker)
+gh devlake configure scope add --plugin bitbucket --org my-workspace
+
 # Add Copilot org scope
 gh devlake configure scope add --plugin gh-copilot --org my-org
 
@@ -109,6 +112,12 @@ gh devlake configure scope add
 3. Creates or reuses a DORA scope config (deployment/production patterns, incident label)
 4. Calls `PUT /plugins/github/connections/{id}/scopes` to add repos
 
+### What It Does (Bitbucket)
+
+1. Resolves workspaces and repos via the DevLake remote-scope API (interactive picker when `--repos` is omitted)
+2. Accepts repo slugs from `--repos` / `--repos-file` (`workspace/repo-slug`)
+3. Calls `PUT /plugins/bitbucket/connections/{id}/scopes` with `bitbucketId` = `workspace/repo-slug`
+
 ### What It Does (Copilot)
 
 1. Computes scope ID from org + enterprise: `enterprise/org`, `enterprise`, or `org`