RAT-369: Improve docs about why we do not fail the build and have empty exclusion files
diff --git a/pom.xml b/pom.xml
index 5d69c39..fbdcbe3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -315,10 +315,11 @@
           <artifactId>spotbugs-maven-plugin</artifactId>
           <version>4.8.4.0</version>
           <configuration>
-            <!-- TODO remove after RAT-369 is done -->
+            <!-- RAT-369: as spotbugs does not allow setting a global (numeric) threshold of currently accepted errors/bugs we do not fail the build -->
             <failOnError>false</failOnError>
             <!-- we only want to see our own problems and in all subpackages -->
             <onlyAnalyze>org.apache.rat.-</onlyAnalyze>
+            <!-- in order to have a global spotbugs configuration an exclusion file needs to exist in all submodules -->
             <excludeFilterFile>${basedir}/spotbugs_ignore.xml</excludeFilterFile>
             <plugins>
               <plugin>