Bits Code: add GitLab support (#37572)

* Add GitLab setup instructions in tabs

* Mention GitLab on Bits Code overview page

* Add Supported source code platforms section

* Fix GitLab Dedicated classification and wording

* Link Setup page to supported platforms section

* Add GitLab Dedicated to supported platforms

* Link Developer role and group to GitLab docs

* Link only group, not article, in GitLab tab

* Reword token scopes and link to GitLab docs

* Generalize PR collaboration section to source code providers

* Fix broken [14] reference: define on Setup, drop from overview

* Reword GitLab step and link service account

* Repoint Datadog link to [6], drop duplicate [14]

* Define [14] reference for Datadog link on Setup

* Use 'providers' instead of 'platforms' for SCM consistency

* Restore [14]->[6] link consolidation on Setup

* Use pull/merge request terminology for GitLab

* Use consistent PRs/MRs plural in pull/merge terminology

* Scope PR troubleshooting entry to GitHub

* Lil tweaks

Co-authored-by: Cara Reaume <35357020+clreaume@users.noreply.github.com>

* Adding merge request language to Automations

* Clarifying supported plans

* Incorporating feedback from Bryce!

* Just fixing one stray header with a slash

* Apply another round of suggestions from code review

Co-authored-by: Bryce Eadie <bryce.eadie@datadoghq.com>
Co-authored-by: Cara Reaume <35357020+clreaume@users.noreply.github.com>

---------

Co-authored-by: datadog-bits <no-reply@dtdg.co>
Co-authored-by: Bryce Eadie <bryce.eadie@datadoghq.com>

Author: 3 people

content/en/bits_ai/bits_ai_dev_agent/_index.md

@@ -14,16 +14,25 @@ further_reading:
 
 ## Overview
 
-Bits Code is a generative AI coding assistant that uses Datadog observability data to automatically diagnose and fix issues in your code. It integrates with GitHub to create production-ready pull requests, then iterates on changes using CI logs and developer feedback.
+Bits Code is a generative AI coding assistant that uses Datadog observability data to automatically diagnose and fix issues in your code. It integrates with [source code providers](#supported-source-code-providers) to create production-ready pull or merge requests, then iterates on changes using CI logs and developer feedback.
 
 {{< img src="bits_ai/dev_agent/sessions_overview.png" alt="A tab titled 'Sessions' shows a text field with suggestions underneath" style="width:100%;" >}}
 
 Each time Bits Code investigates an issue or generates a fix, it creates a [session](#sessions), which captures the agent's analysis, actions, and any resulting code changes across supported Datadog products. Set up [automations][28] to have Bits Code run sessions on a schedule or in response to signals from other Datadog products, such as a new APM Recommendation or flaky test.
 
-To get started with Bits Code, [set up the GitHub integration][6] and complete any additional configuration. Then, [start your first session](#start-a-session).
+To get started with Bits Code, [set up a source code integration][6] and complete any additional configuration. Then, [start your first session](#start-a-session).
 
 Learn how your Bits Code usage is billed on [AI Credits][27].
 
+## Supported source code providers
+Bits Code supports the following source code providers:
+- **GitHub**: GitHub.com and [GitHub Enterprise Cloud][30]
+- **GitLab**: GitLab.com
+
+The following plans are not supported:
+- **Self-hosted plans**, such as GitHub Enterprise Server and GitLab Self-Managed.
+- **Cloud-hosted plans on dedicated domains**, such as [GitHub Enterprise Cloud with data residency][31] and [GitLab Dedicated][32]. Bits Code supports only providers on the standard GitHub.com and GitLab.com domains.
+
 ## Sessions
 A session captures a segment of work with Bits Code, including its analysis and code changes. Start, view, and manage your sessions at **Bits AI** > **Bits Code** > [**Sessions**][7].
 
@@ -38,7 +47,7 @@ After [completing setup][6], do one of the following to start a Bits Code sessio
 A session can also be created when another Bits AI agent (like [Bits Chat][16] or [Bits Investigation][17]) hands off a coding task to Bits Code.
 
 ### View and manage sessions
-On **[Sessions][7]**, view your past sessions in the **My Sessions** panel. A session appears here if you initiated it or interacted with it in some way, like participating in the conversation or creating an associated PR.
+On **[Sessions][7]**, view your past sessions in the **My Sessions** panel. A session appears here if you initiated it or interacted with it in some way, like participating in the conversation or creating an associated PR or MR.
 
 Click a session to view its details and continue working with Bits Code. To remove a session from your **My Sessions** list, click <i class="icon-archive-wui"></i> (**Archive for everyone**) or <i class="icon-eye-slashed-wui"></i> (**Unwatch session**).
 
@@ -74,18 +83,18 @@ Use the freeform prompt field at [**Sessions**][7] to work with Bits Code on gen
 
 ### Automations
 
-[Automations][28] run Bits Code sessions automatically, on a schedule or in response to signals from Datadog products like Error Tracking, APM, or Code Security. After a session completes, Bits Code delivers the results as a pull request, a draft PR, or a Slack notification.
+[Automations][28] run Bits Code sessions automatically, on a schedule or in response to signals from Datadog products like Error Tracking, APM, or Code Security. After a session completes, Bits Code delivers the results as a pull or merge request (optionally in draft mode) or a Slack notification.
 
 You can build automations from triggers (a product finding, a custom prompt, a schedule, or a combination) and configure one or more outputs. Datadog-provided templates are also available to help you get started. Create and manage automations at **Bits AI** > **Bits Code** > [**Automations**][29].
 
-### Pull request collaboration
+### Pull or merge request collaboration
 
-Bits Code integrates with GitHub to:
-- Create pull requests, generating titles and descriptions based on your repository's pull request template
-- Iterate on pull requests in response to comments; mention `@Datadog` in a comment to prompt Bits for updates
+Bits Code integrates with [source code providers](#supported-source-code-providers) to:
+- Create pull or merge requests, generating titles and descriptions based on your repository's pull or merge request template
+- Iterate on pull or merge requests in response to comments; mention `@Datadog` in a comment to prompt Bits for updates
 - Monitor CI logs and fix failures
 
-Bits Code never auto-merges PRs. See all the PRs that Bits Code is working on in **Bits AI** > **Bits Code** > **[Sessions][7]**.
+Bits Code never auto-merges PRs or MRs. See all the PRs or MRs that Bits Code is working on in **Bits AI** > **Bits Code** > **[Sessions][7]**.
 
 ## Limitations
 
@@ -107,7 +116,6 @@ Bits Code never auto-merges PRs. See all the PRs that Bits Code is working on in
 [10]: /profiler/automated_analysis/
 [12]: /containers/
 [13]: /containers/bits_ai_kubernetes_remediation
-[14]: https://app.datadoghq.com/code/settings
 [15]: /security/code_security/static_analysis/ai_enhanced_sast/#remediation
 [16]: /bits_ai/bits_chat/
 [17]: /bits_ai/bits_ai_sre/
@@ -121,3 +129,6 @@ Bits Code never auto-merges PRs. See all the PRs that Bits Code is working on in
 [27]: /account_management/billing/ai_credits/
 [28]: /bits_ai/bits_ai_dev_agent/automations/
 [29]: https://app.datadoghq.com/code/automations
+[30]: https://docs.github.com/en/enterprise-cloud@latest/admin/overview/about-github-enterprise-cloud
+[31]: https://docs.github.com/en/enterprise-cloud@latest/admin/overview/about-github-enterprise-cloud#about-data-residency
+[32]: https://docs.gitlab.com/subscriptions/gitlab_dedicated/

content/en/bits_ai/bits_ai_dev_agent/automations.md

@@ -9,15 +9,15 @@ further_reading:
 ---
 
 ## Overview
-Create an automation to have Bits Code start a [session][1] when a trigger fires, such as a new Code Security finding or a recurring schedule, then deliver the results as a pull request or Slack notification.
+Create an automation to have Bits Code start a [session][1] when a trigger fires—such as a new Code Security finding or a recurring schedule. Bits Code delivers the results as a pull or merge request, or a Slack notification.
 
 {{< img src="bits_ai/dev_agent/automations/list.png" alt="Under an 'Automate with Bits' title, a table with columns like Name, Author, and Last Run has four rows." style="width:100%;" >}}
 
 With Bits Code automations, you can:
 
 - Generate code fixes on a schedule, without starting each session manually
 - Have Bits Code respond to signals from other Datadog products, such as a new APM Recommendation, a flaky test, or a Code Security finding
-- Route the resulting code changes directly to a pull request or notify a team in Slack
+- Route the resulting code changes directly to a pull or merge request, or notify a team in Slack
 
 ## Prerequisites
 To set up a Bits Code automation, each of the following must be true:
@@ -44,8 +44,8 @@ To create a custom Bits Code automation:
 ### Create an automation from a template
 Find Datadog-provided automation templates in the **Automation Templates** section. These may include:
 
-- **Create PRs based on APM Recommendations**: Generates pull requests based on APM Recommendations for a specific service.
-- **Fix frequent errors for a repo**: Uses the [**Custom Prompt**](#custom-prompt-trigger) trigger to instruct Bits Code to scan the last 24 hours of logs, find the most frequent error, and open a pull request with a fix.
+- **Create PRs based on APM Recommendations**: Generates pull or merge requests based on APM Recommendations for a specific service.
+- **Fix frequent errors for a repo**: Uses the [**Custom Prompt**](#custom-prompt-trigger) trigger to instruct Bits Code to scan the last 24 hours of logs, find the most frequent error, and open a pull or merge request with a fix.
 
 Click a template tile to be taken to the new automation form. You must configure an [output](#outputs) before creating the automation.
 
@@ -58,7 +58,7 @@ A trigger defines when an automation runs and what Bits Code acts on. A trigger
 
 Click **Add Trigger** to add a component. You can combine a product finding with a schedule, a custom prompt with a schedule, or use a product finding on its own.
 
-To limit how many Bits Code sessions the automation can create in a given period (for example, `5 runs per Week`), click **Add Trigger** > **Set max runs**. One automation execution may produce more than one session. Use this setting to control the volume of pull requests or notifications an automation produces.
+To limit how many Bits Code sessions the automation can create in a given period (for example, `5 runs per Week`), click **Add Trigger** > **Set max runs**. One automation execution may produce more than one session. Use this setting to control the volume of pull or merge requests, or Slack notifications, an automation produces.
 
 ### Product finding trigger
 A product finding trigger runs the automation in response to new issues in another Datadog product (for example, Error Tracking or Code Security). You can use a product finding trigger by itself, which runs the automation whenever there is a new finding, or with a [schedule](#schedule-trigger) and lookback window you define (in the **New findings within** field).
@@ -69,7 +69,7 @@ When setting up a product finding trigger, you can configure additional filters,
   - **Flaky Tests** supports filtering by **Repository**, **Branch** (defaults to the repository's default branch), and **Status**.
   - **Code Security (SAST)** supports filtering by **Repository**, **Severity**, **Rule to remediate**, and a toggle to **Filter out findings identified as false positives by Bits AI**.
 
-<div class="alert alert-warning">Each finding that triggers an automation is tied to a single session. Multiple findings cannot be fixed in a single session or pull request.</div>
+<div class="alert alert-warning">Each finding that triggers an automation must have its own session, and related pull or merge request. Multiple findings cannot be fixed in a single session.</div>
 
 ### Custom prompt trigger
 A custom prompt tells Bits Code what to do each time the automation runs, in freeform text, against a chosen repository. Use a custom prompt for recurring maintenance tasks that aren't tied to a specific Datadog signal, such as updating dependencies or refreshing documentation.
@@ -80,17 +80,17 @@ A schedule trigger controls when an automation runs. It can be used in combinati
   - **Custom Schedule**: Choose specific days of the week and a time of day (for example, `Mo, We, Fr at 03:00 pm`).
 
 ## Outputs
-An output defines what Bits Code does after a [session][1] completes. An automation can have one or more outputs, including [opening a pull request](#pull-request-output) and [generating a Slack notification](#slack-message-output).
+An output defines what Bits Code does after a [session][1] completes. An automation can have one or more outputs, including [opening a pull or merge request](#pull-or-merge-request-output) and [generating a Slack notification](#slack-message-output).
 
-### Pull request output
+### Pull or merge request output
 You can configure your automation to:
-- **Create a PR**: Open a pull request with the proposed changes
-- **Draft a PR**: Open a draft pull request with the proposed changes
+- **Create a PR or MR**: Open a pull or merge request with the proposed changes
+- **Draft a PR or MR**: Open a draft pull or merge request with the proposed changes
 
-As the author of a Bits Code automation, you are the author of all pull requests it generates.
+As the author of a Bits Code automation, you are the author of all pull or merge requests it generates.
 
 ### Slack message output
-You can configure your automation to send a Slack message summarizing the [session][1] and code changes. If you use a pull request output in addition to a Slack output, Bits Code includes a link to the pull request in the Slack message.
+You can configure your automation to send a Slack message summarizing the [session][1] and code changes. If you use a pull or merge request output in addition to a Slack output, Bits Code includes a link to the pull or merge request in the Slack message.
 
 When you add a Slack message output, by default, Bits Code sends the message to the channel configured for the affected service in [Catalog][5]. You can set a fallback Slack channel, which is used when no channel is set in Catalog.