I think it might be helpful to have these comments as print statements so that the output is explained as it is generated.