Add missing doc comments, remove redundant serialization descriptions.

Got agreement from dave on the second point.
"inside a voting pool bucket" should specify it's the voting pool bucket defined by the votingPoolID.

"The voting pool bucket" is ambiguous. You could mean the general voting pool bucket or the specific bucket for the voting pool id underneath. You mean the latter.