Update README.rst

Exmaples, todos and warnings