README and refactoring, improved examples
readme
fix the build