readme.markdown: fix grammar
readme.markdown: add an example with promises