docs tweaks

Author: FGasper

internal/retry/retry.go

@@ -18,15 +18,17 @@ type RetryCallback = func(context.Context, *FuncInfo) error
 // Run() runs each given callback in parallel. If none of them fail,
 // then no error is returned.
 //
-// If one of them fails, the other allbacks' contexts are canceled.
+// If one of them fails, the other callbacks' contexts are canceled.
 // If the error is non-transient, it's returned. If the error is transient,
-// though, then every function will be retried.
+// though, then the retryer reruns each callback.
 //
-// The retries last until a function fails and it's exceeded the retryer's
-// limit without either a success or being canceled (i.e., because another
-// thread fails).
+// The retryer tracks the last time each callback either a) succeeded or b)
+// was canceled. Whenever a callback fails, the retryer checks how long it
+// has gone since a success/cancellation. If that time period exceeds the
+// retryer's duration limit, then the retry loop ends, and a
+// RetryDurationLimitExceededErr is returned.
 //
-// Note that, if a given callback runs multiple potentially-retryable reqeusts,
+// Note that, if a given callback runs multiple potentially-retryable requests,
 // each successful request should be noted in the callback's FuncInfo.
 // See that struct's documentation for more details.
 //