Scala devel examples and Scaladoc

It is a closely guarded secret that there's good number of examples
for various Scala libraries and features available through the obscure
sbaz command. Just to make sure you know what I'm talking about, do
this:

sbaz install scala-devel-docs

And then look inside scala-x.y.z-final/doc/scala-devel-docs.

Anyway, I think some of these examples could be moved to the Scaladoc
of the related classes -- particularly if they are devoid of any
example at all -- and the Scaladocs, could also mention the existence
of these examples. What do you guys think?