Skip to content

Scrapy, a fast high-level web crawling & scraping framework for Python.

Update docs - improve clarity

harshasrinivas10741aca7202
diff --git a/docs/topics/downloader-middleware.rst b/docs/topics/downloader-middleware.rst
index b808a6448..0d168017f 100644
--- a/docs/topics/downloader-middleware.rst
+++ b/docs/topics/downloader-middleware.rst
@@ -852,10 +852,10 @@ Default: ``2``
Maximum number of times to retry, in addition to the first download.
-.. reqmeta:: max_retry_times
-
-If :attr:`Request.meta <scrapy.http.Request.meta>` has ``max_retry_times`` key
-set to some value, this setting will be ignored by this middleware for the corresponding request.
+Maximum number of retries can also be specified per-request using
+:reqmeta:`max_retry_times` attribute of :attr:`Request.meta <scrapy.http.Request.meta>`.
+When initialized, the :reqmeta:`max_retry_times` meta key takes higher
+precedence over the :setting:`RETRY_TIMES` setting.
.. setting:: RETRY_HTTP_CODES
diff --git a/docs/topics/request-response.rst b/docs/topics/request-response.rst
index 64a1e55fa..03918fd2d 100644
--- a/docs/topics/request-response.rst
+++ b/docs/topics/request-response.rst
@@ -348,7 +348,9 @@ Whether or not to fail on broken responses. See:
max_retry_times
---------------
-The meta key is used set retry times per request. When initialized, the :setting:`RETRY_TIMES` setting will be ignored by the downloader middleware.
+The meta key is used set retry times per request. When initialized, the
+:reqmeta:`max_retry_times` meta key takes higher precedence over the
+:setting:`RETRY_TIMES` setting.
.. _topics-request-response-ref-request-subclasses: