adding docs for observers

fixes #3065