Could you write something about dos and donts :-)

[Laro88]

It would be great with a textual "do this to..." and "do not do this since ..:"

The "too many" exit & immediate enter problematics should also be mentioned (self entry).

Besides:
How to access the current state (if state inherits a shared baseclass, then how to get acces to this / cast state to this)