diff --git a/best_practices.rst b/best_practices.rst
index f18c756c2fc..537bdc4637f 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -378,7 +378,8 @@ Use Voters to Implement Fine-grained Security Restrictions
 
 If your security logic is complex, you should create custom
 :doc:`security voters </security/voters>` instead of defining long expressions
-inside the ``@Security`` annotation.
+inside the ``Security`` attribute
+(or annotation if your PHP version doesn't support attributes yet).
 
 Web Assets
 ----------