add some doco move some stuff around