Use scaladoc comments. http://docs.scala-lang.org/style/scaladoc.html