add scaladoc comments