improve some comments in the AI method