Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
It returns a map of the series keyed by seriesID. The comment makes it sound like you just get a list.