more tidying up of documentation