First draft of user manual

The first (incomplete) draft of the user manual with a couple of
diagrams. Must remember to include ref to the actual book the image is
from