Improve scaladoc output (src links, start page, pkg docs)

This adds a meaningful start page to our api docs, adds main packages summaries and enables scaladoc features: link to source, groups, diagram (the latter of which require graphviz and will issue warnings if it can't be found when creating api docs)

review by @szeiger  /cc: @jamesward