better readme

added link to Cookbook, fixed code blocks to use syntax highlighting,
added breaklines at first code block to fix how it shows up at yardoc.