doc of params fixed