doc;
decorates the function
returns a promise when called
passes the promise handle into the function at arg 1
xit 'returns before the function call'
0.0.1