diff --git a/composer/Plugin/VendorHardening/VendorHardeningPlugin.php b/composer/Plugin/VendorHardening/VendorHardeningPlugin.php
index 1de19be205..71410c4dd6 100644
--- a/composer/Plugin/VendorHardening/VendorHardeningPlugin.php
+++ b/composer/Plugin/VendorHardening/VendorHardeningPlugin.php
@@ -147,9 +147,11 @@ public function onPostPackageUpdate(PackageEvent $event) {
   /**
    * Remove bin config for packages that would have the bin file removed.
    *
-   * @param \Composer\Package\CompletePackage $package
+   * Where the configured bin files are in the directories to be removed, remove
+   * the bin config.
    *
-   * @see https://www.drupal.org/project/drupal/issues/3082866
+   * @param \Composer\Package\CompletePackage $package
+   *   The package we're cleaning up.
    */
   protected function removeBinBeforeCleanup(CompletePackage $package) {
     // Only do this if there are binaries and cleanup paths.
@@ -178,7 +180,9 @@ protected function removeBinBeforeCleanup(CompletePackage $package) {
    * Find bin files which are inside cleanup directories.
    *
    * @param string[] $binaries
+   *   'Bin' configuration from the package we're cleaning up.
    * @param string[] $clean_paths
+   *   The paths we're cleaning up.
    *
    * @return string[]
    *   Bin files to remove, with the file as both the key and the value.