[ADD] explanations of the modifications in the code