Write a comprehensive user guide

[alexdewar]

This task is likely to be a long-running one and we should probably tackle bits of it as we go along, though most of the work should be left till the end of the project at which point we'll know exactly what form the program will take and so we'll be able to write a better guide.