Motivating examples

People won't take the time to read and understand each example.
You have to describe each example and explain why it's great.
document single value output
Merge branch 'gelisam-doc'