From 4e30c818d0e0158e40430dc9981896bec153d296 Mon Sep 17 00:00:00 2001
From: xingzihai <1315258019@qq.com>
Date: Wed, 1 Apr 2026 20:58:01 +0000
Subject: [PATCH] docs: clarify label support across git-open-pr providers

This commit adds documentation to clarify that not all Git providers
support the labels feature in the git-open-pr step:

- GitHub, GitLab, and Azure DevOps support labels
- Gitea does not currently support labels (refs #6021)
- Bitbucket does not support labels at all through its APIs

Fixes #6024
---
 .../30-promotion-steps/git-open-pr.md               | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-open-pr.md b/docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-open-pr.md
index e38a2c3433..a9373219cb 100644
--- a/docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-open-pr.md
+++ b/docs/docs/50-user-guide/60-reference-docs/30-promotion-steps/git-open-pr.md
@@ -13,6 +13,17 @@ specified source and target branches. This step is often used after a
 At present, this feature only supports GitHub, Gitea, Azure DevOps, and
 GitLab pull/merge requests.
 
+:::note
+
+Not all providers support all features. Specifically:
+
+- **Labels**: GitHub, GitLab, and Azure DevOps support labeling pull/merge
+  requests. Gitea does not currently support labels (see
+  [#6021](https://github.com/akuity/kargo/issues/6021) for status). Bitbucket
+  does not support labeling of any kind through its APIs.
+
+:::
+
 ## Credentials
 
 Git steps are utilizing the [repository credentials](../../50-security/30-managing-secrets.md#repository-credentials)
@@ -30,7 +41,7 @@ system to access the git repos.
 | `createTargetBranch` | `boolean` | N | **Deprecated**. Is a no-op if set. Will be removed in a future release.|
 | `title` | `string` | N | The title for the pull request. Kargo generates a title based on the commit messages if it is not explicitly specified. |
 | `description` | `string` | N | The description for the pull request. |
-| `labels` | `[]string` | N | Labels to add to the pull request. |
+| `labels` | `[]string` | N | Labels to add to the pull request. **Note:** Not all providers support labels. GitHub, GitLab, and Azure DevOps support this feature, but Gitea and Bitbucket do not. |
 
 ## Output