update inline docs for observer;