more doc improvements