If we could add some javadocs for the new methods that would be great.