make docs updated and handle oneshot failures