add note about state machines