(#1224) - unreverts and fixes don't mutate options object
(#848) - Update docs with promise info.