From b7903fee59d6901f1901d2babb33555f150b0601 Mon Sep 17 00:00:00 2001
From: Solaris-star <820622658@qq.com>
Date: Sun, 23 Aug 2026 15:11:32 +0800
Subject: [PATCH] docs: clarify EWMA proxy timing

Signed-off-by: Solaris-star <820622658@qq.com>
---
 decor/speed.go | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/decor/speed.go b/decor/speed.go
index a09712b9..9973ca71 100644
--- a/decor/speed.go
+++ b/decor/speed.go
@@ -39,6 +39,10 @@ func (s *speedFormatter) Format(st fmt.State, verb rune) {
 // EwmaSpeed exponential-weighted-moving-average based speed decorator.
 // For this decorator to work correctly you have to measure each iteration's
 // duration and pass it to one of the (*Bar).EwmaIncr... family methods.
+//
+// ProxyReader and ProxyWriter report each wrapped I/O operation as an iteration,
+// so delays between calls are excluded. Use [AverageSpeed] when throughput
+// should include idle time over the bar's complete lifetime.
 func EwmaSpeed(unit any, format string, age float64, wcc ...WC) Decorator {
 	return MovingAverageSpeed(unit, format, NewThreadSafeMovingAverage(ewma.NewMovingAverage(age)), wcc...)
 }