some feedback on the documentation that was added today:
please don't document things that you can read in the code (or the javadoc). you only have to explain concepts and things that are not obvious from reading the code or the javadoc.
this is easier to seach information when you need it and it's even less keystrokes :)
