DX for new developer onboarding

• README should be reorganized per https://www.makeareadme.com/#template-1
• README has duplicate sections
• Add CONTRIBUTING.md
• Update update-readme.py

---

• Readme reorg
• Few readme typos
• https://gitlab.com/gitlab-com/customer-success/tools/congregate/issues/116