added more javadocs for two main datastructure