Cleanup: review feedback fixes and missing CI provider assets

flaky-tests/detection.md

@@ -107,14 +107,14 @@ Trunk classifies all tests into one of three categories based on the history of
 
 ### How Trunk detects broken tests
 
-Threshold monitors detect broken tests alongside flaky tests. When a test's failure rate exceeds the configured threshold and the failures are consistent rather than intermittent, Trunk classifies the test as **Broken** instead of **Flaky**.
+[Threshold monitors](dashboard.md#monitors) detect broken tests alongside flaky tests. When a test's failure rate exceeds the configured threshold and the failures are consistent rather than intermittent, Trunk classifies the test as **Broken** instead of **Flaky**.
 
 The key difference is the failure pattern:
 
 * **Flaky**: Failures are intermittent — the test sometimes passes and sometimes fails on the same code.
 * **Broken**: Failures are consistent — the test fails reliably above the threshold without intermittent passes.
 
-Broken detection events appear in the test case detail view alongside flaky detection events. In the events panel, broken events are displayed as a distinct series so you can track when tests transition between healthy, flaky, and broken states.
+Broken detection events appear in the test case detail view alongside flaky detection events. In the events panel, broken and flaky events are shown as separate series so you can track when tests transition between healthy, flaky, and broken states.
 
 {% hint style="info" %}
 A test can transition between states over time. For example, a test might start as healthy, become flaky as a race condition surfaces, and eventually be classified as broken if the underlying issue causes consistent failures.

flaky-tests/get-started/ci-providers/atlassian-bamboo.md

@@ -128,7 +128,7 @@ variables:
 ```
 {% endtab %}
 
-{% tab title="XCode" %}
+{% tab title="Xcode" %}
 ```yaml
 version: 2
 plan:

merge-queue/integration-for-slack.md

@@ -80,7 +80,7 @@ To receive personal Slack notifications, you'll need to connect both your GitHub
 
 The Trunk Slack app's **Home** tab provides a personal merge queue dashboard directly in Slack. Open the Trunk app in Slack and click the **Home** tab to see an overview of your merge queue activity.
 
-### What you'll see
+### What You'll See
 
 The Home tab displays the following sections:
 
@@ -93,13 +93,13 @@ The Home tab displays the following sections:
 
 Each PR entry shows the PR title, number, a link to the Trunk dashboard, and a link to the GitHub PR. All data is scoped to your PRs via your linked GitHub account.
 
-### Linking your account
+### Linking Your Account
 
 1. Open the Trunk app in Slack and go to the **Home** tab
 2. Click **Link Account** to connect your Trunk account
 3. Click **Connect GitHub** to link your GitHub account (required for PR tracking and most notifications)
 
-### Managing notification preferences
+### Managing Notification Preferences
 
 You can toggle notification topics on or off directly from the Home tab — no need to visit the Trunk web UI. Changes take effect immediately. The available topics are the same as those listed in [Available Notification Topics](integration-for-slack.md#available-notification-topics).
 

merge-queue/reference/merge.md

@@ -180,7 +180,7 @@ Use these endpoints to create, configure, and manage merge queues. Each queue ta
 {% endopenapi-operation %}
 
 {% hint style="warning" %}
-The queue must be empty before it can be deleted. Cancel or merge all enqueued PRs first.
+The queue must be empty before it can be deleted. Cancel all enqueued PRs or wait for them to be merged first.
 {% endhint %}
 
 {% openapi-operation spec="trunk-api" path="/getQueue" method="post" %}

merge-queue/using-the-queue/monitor-queue-status.md

@@ -41,7 +41,9 @@ View status of the queue and recent activity in the **Queue** tab
 
 ### Graph view
 
-The graph view shows all PRs currently being tested by Trunk Merge Queue and their relationships. Each node represents a pull request, and each edge indicates that the PR is testing with the item above and depends on it. All edges point towards the target branch; as items merge, the affected queues restructure. If running in `Single` mode, this will be a single line showing the testing and merging process.
+The graph view shows all PRs currently being tested by Trunk Merge Queue and their relationships. Each node represents a pull request, and each edge indicates that the PR is testing with the item above and depends on it. All edges point towards the target branch; as items merge, the affected queues restructure.
+
+If running in `Single` mode, this will be a single line showing the testing and merging process.
 
 #### Reading the graph