Modified reference/promise-types.markdown to merge notes and syposis sections into a description section.