documented observers. fixes #43