Mau/doc overhaul

rebase of dave/doc-overhaul as per GH#255

This all bigpresh's work from Dancer2/dave/doc-overhaul from March 1.