examples: add some clarifying comments on error checking

Signed-off-by: Greg Farnum <greg@inktank.com>