better docstring for GatedState
better SingleTargetState docstring
better docstring for BaseMachine