document deprecated dont_filter flag in OffsiteMiddleware

scrapy · Nov 28, 2023 · ec75a07 · ec75a07
1 parent e179e44
commit ec75a07
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/topics/spider-middleware.rst b/docs/topics/spider-middleware.rst
@@ -349,6 +349,11 @@ OffsiteMiddleware
    offsite middleware will allow the request even if its domain is not listed
    in allowed domains.
 
+   .. caution:: Setting :attr:`~scrapy.Request.dont_filter` to ``True`` also
+                causes the offsite middleware to allow the request. However,
+                this is deprecated. Use ``allow_offsite`` instead in
+                :attr:`Request.meta`.
+
 
 RefererMiddleware
 -----------------