EXP-403. Scaladoc cleanup for *Spec classes.

issue: https://jira.kiji.org/browse/EXP-403
review: https://review.kiji.org/r/1573