Cleanup: Remove redundant comments

Author: pH-7

src/Action/User/ListUsersAction.php

@@ -8,9 +8,6 @@
 
 class ListUsersAction extends UserAction
 {
-    /**
-     * {@inheritdoc}
-     */
     protected function action(): Response
     {
         $users = $this->userRepository->findAll();

src/Domain/User/Service/UserCreator.php

@@ -15,11 +15,6 @@ final class UserCreator
 
     private UserCreatorRepository $repository;
 
-    /**
-     * The constructor.
-     *
-     * @param UserCreatorRepository $repository The repository
-     */
     public function __construct(UserCreatorRepository $repository)
     {
         $this->repository = $repository;
@@ -34,27 +29,13 @@ public function __construct(UserCreatorRepository $repository)
      */
     public function createUser(array $data): int
     {
-        // Input validation
         $this->validateNewUser($data);
 
-        // Insert user
         $userId = $this->repository->insertUser($data);
 
-        // Logging here: User created successfully
-        //$this->logger->info(sprintf('User created successfully: %s', $userId));
-
         return $userId;
     }
 
-    /**
-     * Input validation.
-     *
-     * @param array $data The form data
-     *
-     * @return void
-     * @throws ValidationException
-     *
-     */
     private function validateNewUser(array $data): void
     {
         $validator = new Validator($data);

src/Domain/User/Service/UserReader.php

@@ -20,24 +20,20 @@ public function __construct(UserReaderRepository $repository)
     /**
      * Read a user by the given user id.
      *
-     * @param int $userId The user id
-     *
-     * @throws ValidationException
+     * @param int|null $userId The user id
      *
      * @return UserReaderResult The user data
+     *
+     * @throws ValidationException
      */
-    public function getUserDetails(int $userId): UserReaderResult
+    public function getUserDetails(?int $userId): UserReaderResult
     {
-        // Input validation
         if (empty($userId)) {
             throw new ValidationException('User ID required');
         }
 
         $userRow = $this->repository->getUserById($userId);
 
-        // Optional: Do something complex here...
-
-        // Map array to data object
         $user = new UserReaderResult();
         $user->id = (int)$userRow['id'];
         $user->username = (string)$userRow['username'];