Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
Can you do this one? This needs a better comment.