docs(merge-queue): changelog for config checker panel improvements (v204)

changelog/2026-06-15-merge-queue-config-checker-improvements.mdx

@@ -0,0 +1,20 @@
+---
+title: "Merge Queue: Configuration Issues Panel Improvements"
+description: "The Configuration Issues tab now has a Recheck button, shows rule-level hints, auto-expands failing checks, and orders details to show the fix first."
+date: 2026-06-15
+category: Merge Queue
+type: update
+---
+
+**The Configuration Issues panel in Merge Queue administration is easier to act on: a Recheck button lets you re-run the validator on demand, and each issue now puts the fix first.**
+
+Four changes shipped in this release:
+
+- **Recheck on demand.** A **Recheck** button on the Configuration Issues tab re-runs the ruleset validator immediately. Previously, the panel only refreshed when the backend rescanned on its own schedule. Use it after making a configuration change to confirm the issue is resolved without waiting.
+- **Rule-level hints.** Individual config issues can now include hints, a list of supplementary guidance specific to that rule. Hints appear below the Solution step and above the Sources list, and are omitted when the backend does not return any for a given rule. For example, a branch-targeting rule may surface a near-miss pattern to help you identify a typo in a branch name.
+- **Auto-expanded failing checks.** Rows that are failing or warning now open by default when you land on the Issues tab. Previously all rows were collapsed. This saves a click when the reason you navigated to the tab is to read an error.
+- **Fix-first detail order.** The issue detail cards now show Solution before Cause, so the actionable step appears before the explanation. The full order is: Solution, Cause, Hints, Sources.
+
+Source: [trunk-io/trunk2#4170](https://github.com/trunk-io/trunk2/pull/4170)
+
+Co-Authored-By: Claude <noreply@anthropic.com>

changelog/index.mdx

@@ -8,6 +8,12 @@ rss: true
 
 ### June 2026
 
+<Update label="June 15, 2026" tags={["Merge Queue"]}>
+  **[Merge Queue: Configuration Issues Panel Improvements](/changelog/2026-06-15-merge-queue-config-checker-improvements)**
+
+  The Configuration Issues tab now has a Recheck button, shows rule-level hints, auto-expands failing checks, and orders details to show the fix first.
+</Update>
+
 <Update label="June 8, 2026" tags={["Merge Queue"]}>
   **[Merge Queue: Browser Extension Now Supports Firefox](/changelog/2026-06-08-merge-queue-firefox-extension)**
 

docs.json

@@ -624,6 +624,7 @@
               {
                 "group": "June",
                 "pages": [
+                  "changelog/2026-06-15-merge-queue-config-checker-improvements",
                   "changelog/2026-06-08-merge-queue-firefox-extension",
                   "changelog/2026-06-04-merge-queue-chrome-extension-0-8-0"
                 ]

merge-queue/changelog.mdx

@@ -9,6 +9,12 @@ og:title: "Trunk Merge Queue changelog"
 
 ### June 2026
 
+<Update label="June 15, 2026" tags={["Merge Queue"]}>
+  **[Merge Queue: Configuration Issues Panel Improvements](/changelog/2026-06-15-merge-queue-config-checker-improvements)**
+
+  The Configuration Issues tab now has a Recheck button, shows rule-level hints, auto-expands failing checks, and orders details to show the fix first.
+</Update>
+
 <Update label="June 8, 2026" tags={["Merge Queue"]}>
   **[Merge Queue: Browser Extension Now Supports Firefox](/changelog/2026-06-08-merge-queue-firefox-extension)**