Many Scala developers, including those with a great deal of experience, are unaware of some of the more powerful features of Scaladoc.
This is a companion discussion topic for the original entry at http://docs.scala-lang.org//overviews/scaladoc/interface.html