DOC: add documentation on state machines

src/doc/index.rst

src/doc/tutorials.rst

src/doc/tutorials/setup_state_model.py

src/doc/tutorials/statemachine.rst