update docs for observer pattern