Some text updates (reordering, content, typos, links)

Code seems clean. I only changed text by reordering some part (like the promise introduction), add some links to external libraries or example files, fix some typos and some punctuation (spaces around :) and also add or change some titles or sentences.