docs: ACI-5269 name the cooldown parameter so the doc reads as a sentence

"whether every has passed" leaned on the parameter name and read as a dropped
word. It is interval now.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: zsolt-marta-bitrise

internal/bazelcredhelper/cooldown.go

@@ -8,15 +8,15 @@ import (
 	"github.com/gofrs/flock"
 )
 
-// claimCooldown reports whether every has passed since the last claim, re-stamping
-// the marker when it returns true. The marker's mtime is the state; nothing is
-// removed. A failure to stamp reads as "not claimed", so a broken marker stays
-// quiet rather than spamming.
+// claimCooldown reports whether at least interval has passed since the last claim,
+// re-stamping the marker when it has. The marker's mtime is the state; nothing is
+// removed. A failure to stamp reads as "not claimed", so a broken marker stays quiet
+// rather than spamming.
 //
 // The lock is what makes it a rate limiter rather than a suggestion: read-then-stamp
 // is not atomic, and every helper of a build starts in the same instant, so without
-// it they all claim the same window.
-func claimCooldown(path string, every time.Duration) bool {
+// it they would all claim the same window.
+func claimCooldown(path string, interval time.Duration) bool {
 	if err := os.MkdirAll(filepath.Dir(path), 0o700); err != nil {
 		return false
 	}
@@ -29,7 +29,7 @@ func claimCooldown(path string, every time.Duration) bool {
 	defer func() { _ = lock.Unlock() }()
 
 	if info, err := os.Stat(path); err == nil {
-		if time.Since(info.ModTime()) < every {
+		if time.Since(info.ModTime()) < interval {
 			return false
 		}
 		now := time.Now()