EXP-319. Clean up scaladocs in EntityID and some framework classes.

issue: https://jira.kiji.org/browse/EXP-319
review: https://review.kiji.org/r/1406