adding more comments in document and remove commented-out params