cleaned up the comments & descriptions a bit

Awesome project :+1: 

Just sent some stuff over :sheep: 

![hawkward](https://f.cloud.github.com/assets/643325/2405086/8fe84dae-aa47-11e3-82d4-099858f56b4c.jpg)