some comment improvements