add a bit more doco