more doco clarification