add vfs observer
add polling observers to api docs
improve documentation