further doc revision