Rename documentation so github displays markup

Slight documentation fixes, credits to Lamia for some more documentation
that will no doubt be invaluable.