added more scaladocs