Improve title README, add examples outline

[bprashanth]

A tiny step toward consolidated examples and documentation (#2, #9)

[coveralls]

Coverage decreased (-0.05%) to 40.185% when pulling 1bb8d11 on bprashanth:docs into d1fb96a on kubernetes:master.

[bprashanth]

I guess it's complaining that I didn't add any tests for the markdown, merging

[aledbf]

@bprashanth I configured coveralls to throw an error only if the coverage decreases more than 5%

[bprashanth]

Thanks!