Yeah, I'm not a fan of manually added code in the README. It's PITA to maintain and it easily gets out of date.

I'm fine with putting code in the readme, but this code should probably live in `examples/` and be tested and then just put inside the `README.md` during the build / documentation gen process.