Some suggested changes, both errors and rewordings

Python and C code examples tweaked a bit

Signed-off-by: Dan Mick <dan.mick@inktank.com>