Add missing doc comments, remove redundant serialization descriptions.
Got agreement from dave on the second point.
Change as per Jimmy's review.
More changes per Jimmy's review.
One more.