more documentation

Signed-off-by: Paul Newman <pnewman@robots.ox.ac.uk>