v0.34.3

docs/DASHBOARD.md

@@ -26,6 +26,10 @@ Unfinished editors may be minimized into a draft dock; this is a UI convenience
 
 ## Interpreting charts
 
+- The **Cache hit ratio** donut shows cumulative `HIT / (HIT + MISS)`: BYPASS and requests outside cache are deliberately excluded from its denominator.
+- The **Cache outcomes (recent)** compact horizontal 100% bar is **hidden by default**; enable it in **Settings → Appearance → Dashboard layout** or the Overview layout editor. It compares HIT, MISS, BYPASS and OTHER against all HTTP request counter increments in one contiguous sampling interval. BYPASS includes requests for which the cache path was considered but disabled/skipped (including globally disabled cache). OTHER means requests that generated no cache decision, e.g. early rejected or redirect paths. These are request counts, not response bytes. It shows no value until a second valid sample, after background-tab pauses, after counter resets, or when independently observed cache outcomes briefly exceed the requests delta. Revisit the next interval rather than trusting a forced 100% value.
+
+
 - Live views are process/sampling-based and can show no-data when an integration has not reported yet.
 - Per-backend protocol badges can distinguish configured HTTP mode from the protocol actually observed in connection traffic.
 - Response-header timing excludes the full streamed body duration. HTTP server/client percentages refer to the specified layer.