add more doco and 'finish' new design