Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
That' an implementation detail anyway. The comment talks about the method signature and how it's used.