update docs on coroutines