update docs link
refactoring docs
sync with 0.10 (wip), move the async stuff to its own branch