Review this repo and

• Ensure that if people are just skimming, they still understand the major points
• Add table of contents for a quick view of what is in the repo - this provides people with context and lets them know that they can't stop half way down because there's still important stuff to come.