adjusted comments
readme overhaul
Including a TL;DR and improved explanations
Assuming margaritas make for better explanations
Merge branch 'feature/readme' into develop