diff --git a/pmd/etc/changelog.txt b/pmd/etc/changelog.txt
index 3d99367ea6..b1d15039c6 100644
--- a/pmd/etc/changelog.txt
+++ b/pmd/etc/changelog.txt
@@ -54,6 +54,18 @@ TODO - Release blockers - Must implement before this release can be finished
      File/String to a LanguageVersion of a specific Language, one could imaging
      using a 'magic' system like Unix uses to tell different versions of files
      apart based on actual content.
+   o Some cleanup needs to be done on the PMD class.  There are 9! processFile(s)
+     methods, and multiple places which deal with stateful operations
+     (e.g. calling PMD.setExcludeMarker(), PMD.setClassLoader(), RuleSets.start()),
+     further the Benchmarking stuff really only can work for commandline PMD
+     usage, and the RuleSets.start()/end() stuff isn't working for all entry
+     points into the PMD class.  Things need to be simplified and centralized.
+     There should be a clear definition of a lifecycle/sequence of events for
+     the PMD class, so  that various integration points (command line, Ant, IDEs)
+     can be done in a universal and consistent fashion, and all can necessarily
+     leverage the full PMD feature set.  Documentation on this class needs to
+     vastly improved, this should be one of the best documented classes in the
+     code base.
 
 ---