diff --git a/package_manager/src/EventSubscriber/ComposerExecutableValidator.php b/package_manager/src/EventSubscriber/ComposerExecutableValidator.php
index f91e852930321300c2dd5b4067736165ff3dafc1..e1ace839e63d69f4c4304dfe212d9a53cfd0ab53 100644
--- a/package_manager/src/EventSubscriber/ComposerExecutableValidator.php
+++ b/package_manager/src/EventSubscriber/ComposerExecutableValidator.php
@@ -12,7 +12,7 @@ use PhpTuf\ComposerStager\Domain\Process\Runner\ComposerRunnerInterface;
 use PhpTuf\ComposerStager\Exception\ExceptionInterface;
 
 /**
- * Validates that the Composer executable can be found in the correct version.
+ * Validates the Composer executable is the correct version.
  */
 class ComposerExecutableValidator implements PreOperationStageValidatorInterface, OutputCallbackInterface {
 
diff --git a/package_manager/src/EventSubscriber/DiskSpaceValidator.php b/package_manager/src/EventSubscriber/DiskSpaceValidator.php
index c54a653052092cb6f5f6de96292ac8178fea9a0b..f65e42bc13089638fc0d19100193af515882041e 100644
--- a/package_manager/src/EventSubscriber/DiskSpaceValidator.php
+++ b/package_manager/src/EventSubscriber/DiskSpaceValidator.php
@@ -11,7 +11,7 @@ use Drupal\Core\StringTranslation\TranslationInterface;
 use Drupal\package_manager\PathLocator;
 
 /**
- * Validates that there is enough free disk space to do automatic updates.
+ * Validates that there is enough free disk space to do staging operations.
  */
 class DiskSpaceValidator implements PreOperationStageValidatorInterface {
 
@@ -103,7 +103,8 @@ class DiskSpaceValidator implements PreOperationStageValidatorInterface {
     $vendor_path = $this->pathLocator->getVendorDirectory();
     $messages = [];
 
-    // @todo Make this configurable.
+    // @todo Make this configurable or set to a different value in
+    //   https://www.drupal.org/i/3166416.
     $minimum_mb = 1024;
     $minimum_bytes = Bytes::toNumber($minimum_mb . 'M');