First stage of writing documentation for system as a whole

This is mainly about writing the part which covers the overview, but there
are also stubs for description more focussed on the script side of things.