add more comments to questionable code