diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 6f050885c96..4b2aa8681b5 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -118,10 +118,10 @@ This requires you to implement several methods::
 
         public function checkCredentials($credentials, UserInterface $user)
         {
-            // check credentials - e.g. make sure the password is valid
-            // no credential check is needed in this case
+            // Check credentials - e.g. make sure the password is valid.
+            // In case of an API token, no credential check is needed.
 
-            // return true to cause authentication success
+            // Return `true` to cause authentication success
             return true;
         }