Move examples to README

- The readme also contains some information about the code
- Verified examples and added new example for blme
- Fixed the documentation for r.squared.lm