Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
It does not mentioned a data structure, and it should. Fixed.