diff --git a/templates.rst b/templates.rst
index 77e10bc5596..98742058988 100644
--- a/templates.rst
+++ b/templates.rst
@@ -849,7 +849,8 @@ errors. It's useful to run it before deploying your application to production
     $ php bin/console lint:twig templates/email/
     $ php bin/console lint:twig templates/article/recent_list.html.twig
 
-    # you can also show the deprecated features used in your templates
+    # you can also show the first deprecated feature used in your templates
+    # as it shows only the first one found, you may need to run it until no more deprecations are found
     $ php bin/console lint:twig --show-deprecations templates/email/
 
 When running the linter inside `GitHub Actions`_, the output is automatically