Fix scaladocs for ActorMetrics; Add a doc entry for actors

This is to help clarify the question in the [google groups question](https://groups.google.com/d/topic/metrics-user/9sNXVdcsnRk/discussion)