web/templates/pages/alerts.html

@@ -28,6 +28,13 @@
     </div>
   </div>
 
+  {{/* triage legend — Acknowledge vs Resolve looks identical on screen
+       (both leave the Open tab) so the difference needs spelling out. */}}
+  <div class="text-ink-mute mt-2 leading-[1.55]" style="font-size: 11.5px; max-width: 760px;">
+    <span class="text-ink-mid">Acknowledge</span> silences fan-out while the underlying problem is still happening — the alert moves to the Acknowledged tab.
+    <span class="text-ink-mid">Resolve</span> closes the alert; the next failure raises a fresh one with a new notification.
+  </div>
+
   {{/* filter strip */}}
   <div class="panel mt-4 px-4 py-3 rounded-[7px]"
        style="display: grid; grid-template-columns: auto auto auto 1fr; gap: 14px; align-items: center;">

web/templates/partials/alert_row.html

@@ -69,13 +69,15 @@
         {{if $qs}}<input type="hidden" name="qs" value="{{$qs}}">{{end}}
         <button type="submit" class="btn"
                 hx-post="/alerts/{{$a.ID}}/acknowledge{{if $qs}}?{{$qs}}{{end}}"
-                hx-swap="none">Acknowledge</button>
+                hx-swap="none"
+                title="I've seen this — silence further fan-out, but the alert is still open until the condition clears or you Resolve it.">Acknowledge</button>
       </form>
       <form method="post" action="/alerts/{{$a.ID}}/resolve">
         {{if $qs}}<input type="hidden" name="qs" value="{{$qs}}">{{end}}
         <button type="submit" class="btn"
                 hx-post="/alerts/{{$a.ID}}/resolve{{if $qs}}?{{$qs}}{{end}}"
-                hx-swap="none">Resolve</button>
+                hx-swap="none"
+                title="The underlying issue is fixed. Closes the alert. If the condition fires again a fresh alert will be raised with a new fan-out.">Resolve</button>
       </form>
     {{else if eq $status "acknowledged"}}
       <span class="text-ink-fade" style="font-size: 11px;">
@@ -85,7 +87,8 @@
         {{if $qs}}<input type="hidden" name="qs" value="{{$qs}}">{{end}}
         <button type="submit" class="btn"
                 hx-post="/alerts/{{$a.ID}}/resolve{{if $qs}}?{{$qs}}{{end}}"
-                hx-swap="none">Resolve</button>
+                hx-swap="none"
+                title="The underlying issue is fixed. Closes the alert.">Resolve</button>
       </form>
     {{else}}
       <span class="text-ink-fade" style="font-size: 11px;">resolved · {{relTime $a.ResolvedAt}}</span>