Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
The votingPoolBucketName and votingPoolID are different things and the comment overloads this by calling it the "bucket name". maybe "creating a bucket whose key is"?