Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
This is the one set of serialize/deserialize we wrote. Can you put them in the order everything else has?