more doc clairification