a shitload of doc updates
minor clean up based on feedback
add a minor heading
Merge pull request #192 from GoodBoyDigital/docs

Docs-a-palooza