adjusting the documentation
more documentation work
added event handling and implicit vs. explicit `.continue()` documentation