adding state documentation; changing "spying" state/method to more generic "stop_observing"