update documentation + javadoc