adding pieces of documentation, and javadoc