docs: improved examples in README

- moved index iteration example to Indexes section
- added note about avoiding boiler-plate by using ``cheshire3``