diff --git a/docs/topics/settings.rst b/docs/topics/settings.rst
index 40bcda288..022265992 100644
--- a/docs/topics/settings.rst
+++ b/docs/topics/settings.rst
@@ -652,8 +652,9 @@ per ip address instead of per domain.
 
 .. _spider-download_delay-attribute:
 
-You can also change this setting per spider by setting ``download_delay``
-spider attribute.
+.. note::
+
+    This delay can be set per spider using :attr:`download_delay` spider attribute.
 
 .. setting:: DOWNLOAD_HANDLERS