add tl;dr example
update meat of readme to reflect our practices