HBASE-26271: Cleanup the broken store files under data directory

improve naming and add some explanation in the comments

hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/BrokenStoreFileCleaner.java

@@ -77,8 +77,8 @@ public boolean getEnabled() {
     return this.enabled.get();
   }
 
-  @InterfaceAudience.Private
-  @Override public void chore() {
+  @Override
+  public void chore() {
     if (getEnabled()) {
       long start = EnvironmentEdgeManager.currentTime();
       AtomicLong deletedFiles = new AtomicLong(0);
@@ -132,20 +132,22 @@ private void cleanFileIfNeeded(FileStatus file, HStore store,
       return;
     }
 
+    // Compacted files can still have readers and are cleaned by a separate chore, so they have to
+    // be skipped here
     if(isCompactedFile(file, store)){
       LOG.trace("Cleanup is done by a different chore for file {}, skip cleanup", file.getPath());
       return;
     }
 
-    if(isCompactingFile(file, store)){
+    if(isCompactionResultFile(file, store)){
       LOG.trace("The file is the result of an ongoing compaction {}, skip cleanup", file.getPath());
       return;
     }
 
     deleteFile(file, store, deletedFiles, failedDeletes);
   }
 
-  private boolean isCompactingFile(FileStatus file, HStore store) {
+  private boolean isCompactionResultFile(FileStatus file, HStore store) {
     return store.getStoreEngine().getCompactor().getCompactionTargets().contains(file.getPath());
   }