doco improvements
tidying