javadoc added for class
removed broken @see comments
more robust collection content verification