Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
I always left the first one in and removed the second one. I don't know why each element of each serialize/deserialize method pair is not always in the same order.