Added documentation for PyFR-Mako and Improved the User Guide

Reworking of closed request #22. Should all be merged neat and tidy into a single commit.