what, why and how

@pmac tempted to do a r? but I'm confident it's a good start. We just need to polish and tune and keep adding to it. 
What do you think?