diff --git a/redis/sdks/ratelimit-py/algorithms.mdx b/redis/sdks/ratelimit-py/algorithms.mdx
index 042a534e..51076650 100644
--- a/redis/sdks/ratelimit-py/algorithms.mdx
+++ b/redis/sdks/ratelimit-py/algorithms.mdx
@@ -9,6 +9,10 @@ window is 10 seconds long. When a new request comes in, the current time is used
to determine the window and a counter is increased. If the counter is larger
than the set limit, the request is rejected.
+
+ In fixed & sliding window algorithms, the reset time is based on fixed time boundaries (which depend on the period), not on when the first request was made. So two requests made right before the window ends still count toward the current window, and limits reset at the start of the next window.
+
+
### Pros
- Very cheap in terms of data size and computation
@@ -73,6 +77,12 @@ ratelimit = Ratelimit(
)
```
+
+ `reset` field in the [`limit`](/redis/sdks/ratelimit-py/gettingstarted) method of sliding window does not
+ provide an exact reset time. Instead, the reset time is the start time of
+ the next window.
+
+
## Token Bucket
Consider a bucket filled with maximum number of tokens that refills constantly
diff --git a/redis/sdks/ratelimit-ts/algorithms.mdx b/redis/sdks/ratelimit-ts/algorithms.mdx
index 36542ab0..6f1f9de5 100644
--- a/redis/sdks/ratelimit-ts/algorithms.mdx
+++ b/redis/sdks/ratelimit-ts/algorithms.mdx
@@ -11,6 +11,10 @@ window is 10 seconds long. When a new request comes in, the current time is used
to determine the window and a counter is increased. If the counter is larger
than the set limit, the request is rejected.
+
+ In fixed & sliding window algorithms, the reset time is based on fixed time boundaries (which depend on the period), not on when the first request was made. So two requests made right before the window ends still count toward the current window, and limits reset at the start of the next window.
+
+
### Pros
- Very cheap in terms of data size and computation
@@ -116,6 +120,12 @@ Create a new ratelimiter, that allows 10 requests per 10 seconds.
+
+ `reset` field in the [`limit`](/redis/sdks/ratelimit-ts/methods#limit) and [`getRemaining`](/redis/sdks/ratelimit-ts/methods#getremaining) methods of sliding window do not
+ provide an exact reset time. Instead, the reset time is the start time of
+ the next window.
+
+
## Token Bucket
Consider a bucket filled with `{maxTokens}` tokens that refills constantly at