[doc] Add automatic generation of Scaladoc
[scala] Fix Scaladoc of Join and CoGroup Operation

Was still referring to the type of join/coGroup function that returns an
Option.
[scala] Add package documentation for package api.scala