Closes #1015

Our recommendation is that code which wants to `await` the result of an
expectation should use `expectLater`. Update the docs and README to
reflect this.