more scaladocs and javadocs