[finishes #93048180] Update readme with better examples and commentary
[finishes #93048180] Update readme with better examples and commentary

Signed-off-by: Nicole Sullivan <4ab7e2960369063855aad4ef791fa27066322d72@pivotal.io>

bartvde/dr-frankenstyle,pivotal-cf/dr-frankenstyle