Polish up examples (somewhat)

- Mention them in the docs (arguably a bit hamfistedly).
- Make the README an RST.
- Make them pass flake8 and add flake8 to tox.ini

They should all be rewritten and made Python 3-friendly but that's out
of scope here.
12 files changed