docs(merge-queue): configuration issues panel

[samgutentag]

Summary

Adds changelog entry and troubleshooting section for the new Issues tab in the Merge Queue dashboard, which surfaces detected ruleset configuration problems with plain-language explanations and remediation links.

Source

• trunk2 PR: https://github.com/trunk-io/trunk2/pull/4090

Test plan

• Check Mintlify preview link (posted on the PR by the Mintlify GitHub app)

---

Generated by Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
trunk	🟢 Ready	View Preview	Jun 6, 2026, 12:08 PM

[samgutentag]

Verification status (2026-06-25): staged

On in staging only. Re-run after prod rollout.

• Flag state: read directly from LaunchDarkly (production: OFF; test: ON_100). showMergeConfigIssues has on=true in prod but fallthrough serves the disabled variation (false); the only rule enables impersonator ben@trunk.io, so the general population does not see it (targeted beta, not GA). In staging the fallthrough serves the enabling variation to 100%.
• Eng PR: trunk-io/trunk2#4090 (merged; merge commit on main)
• Flag: showMergeConfigIssues (project frontend-web-2)
• Signals: LD direct read (primary). Prod off for general population, staging fully on.
• Optics gate: clear. Forward-facing user gain (config issues surfaced with remediation), not a self-inflicted-bug confession.

Recommendation: keep held. Re-run once showMergeConfigIssues rolls out to the general population in prod.

[samgutentag]

Docs PR Verify · 2026-06-26

Verdict: staged 🟡

Eng PR merged, but feature flag showMergeConfigIssues is OFF in production (ON in test). Waiting for flag to roll out to production before these docs go live.

---

Daily sweep · 2026-06-26

---

Generated by Claude Code