tidy up doco a bit