sync/async madness
update docs