Added better explanation to the class javadocs