contrib: add 'toPromise' plugin, core: update docs, closes #31