updating doco slightly