including comments about the logic

including comments about the logic