Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
again, you need to make clear you're making a sub-bucket off the main voting pools bucket and that the pool id is the key here. The comment makes it seem like the specific voting pool id bucket is a first-order db object, which it's not.