added examples to the readme and godocs

Signed-off-by: Ted Young <tyoung@pivotallabs.com>