Merge pull request #4 from whatasunnyday/readme

 Add examples to README. Improve documentation for yard. Improve yardstick coverage.