diff --git a/docs/content/middlewares/retry.md b/docs/content/middlewares/retry.md
index 439cb9cbf..e7704c862 100644
--- a/docs/content/middlewares/retry.md
+++ b/docs/content/middlewares/retry.md
@@ -5,7 +5,8 @@ Retrying until it Succeeds
 
 `TODO: add schema`
 
-Retry to send request on attempt failure.
+The Retry middleware is in charge of reissuing a request a given number of times to a backend server if that server does not reply.
+To be clear, as soon as the server answers, the middleware stops retrying, regardless of the response status.
 
 ## Configuration Examples
 
@@ -60,4 +61,4 @@ http:
 
 _mandatory_
 
-The `attempts` option defines how many times to try sending the request.
\ No newline at end of file
+The `attempts` option defines how many times the request should be retried.
\ No newline at end of file