Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
That's common to all methods, and we don't want to repeat it all over the place. We probably want to add some description of the bucket hierarchy around line 138.