README: move mandatory keys to the top, correct some links
Merge pull request #93 from zendesk/ben/readme

READMEmd: move mandatory keys to the top, correct some links