comments improvement

package_manager/tests/fixtures/updated_module/1.0.0/src/PreUpdateService.php

@@ -3,7 +3,7 @@
 namespace Drupal\updated_module;
 
 /**
- * Class for pre update services.
+ * A generic service class to prove that services are reloaded after an update.
  */
 class PreUpdateService {
 

package_manager/tests/fixtures/updated_module/1.1.0/src/PostUpdateService.php

@@ -3,7 +3,7 @@
 namespace Drupal\updated_module;
 
 /**
- * Class for post update services.
+ * A generic service class to prove that services are reloaded after an update.
  */
 class PostUpdateService {
 

package_manager/tests/modules/package_manager_test_api/src/SystemChangeRecorder.php

@@ -64,7 +64,7 @@ class SystemChangeRecorder implements EventSubscriberInterface {
    * @param \Drupal\user\PermissionHandlerInterface $permissionHandler
    *   The permission handler service.
    * @param object $changedService
-   *   The changed service.
+   *   A generic service which will be different after the update.
    */
   public function __construct(PathLocator $path_locator, StateInterface $state, RouterInterface $router, PermissionHandlerInterface $permissionHandler, object $changedService) {
     $this->pathLocator = $path_locator;