adding some scaladoc snippets