further documentation enhancements specifically for non-blocking and event loops