Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
minor point, but every other one has the reference in deserialize and the "see the" comment in serialize except for this one.