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.
Added two examples.
Merge pull request #51 from teknico/vp

Add missing doc comments, remove redundant serialization descriptions.