I believe that while a monumental task, this is useful for contributors trying to understand what the code does. For example, look at like ShapeDispatcher.java, where the code is so complicated that it takes quite a while to even begin to understand what's going on.

Actually imma move to a discussion