scala documentation tools - mid 2012 state of the art

Question

I liked Marginalia in the Clojure world. I came across this from Googling: http://blog.8-p.info/2011/02/03/scaladoc.html . What do people recommend? Or are people sticking with Scala Doc to keep with standards/what people are used to?

Answer 1

Scaladoc for API's and XRay (example) (produces browsable source code; it is abandoned but still awesome) are two mastadonts of scala documentation IMO. There is also pamflet (example) and port of docco, but latter to my knowledge is not so popular.