[Security] Fix some phpdoc

Author: chalasr

Authenticator/Passport/Credentials/PasswordCredentials.php

@@ -16,7 +16,7 @@
 /**
  * Implements password credentials.
  *
- * These plaintext passwords are checked by the UserPasswordEncoder during
+ * These plaintext passwords are checked by the UserPasswordHasher during
  * authentication.
  *
  * @author Wouter de Jong <[email protected]>

Authenticator/Passport/Passport.php

@@ -17,7 +17,11 @@
 use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CredentialsInterface;
 
 /**
- * The default implementation for passports.
+ * A Passport contains all security-related information that needs to be
+ * validated during authentication.
+ *
+ * A passport badge can be used to add any additional information to the
+ * passport.
  *
  * @author Wouter de Jong <[email protected]>
  */
@@ -59,6 +63,12 @@ public function getUser(): UserInterface
     }
 
     /**
+     * Adds a new security badge.
+     *
+     * A passport can hold only one instance of the same security badge.
+     * This method replaces the current badge if it is already set on this
+     * passport.
+     *
      * @return $this
      */
     public function addBadge(BadgeInterface $badge): PassportInterface