[fixes #201] doc cleanup, rejections can infact be thenables
doc cleanup