improved comment document