Updated readme to be explicit about promises

Also readded what Amrit put into the README for imageToPdf, which I
accidentally clobbered while reverting :)