На мой взгляд, подробные комментарии в коде нужно писать в случае сложной\запутанной логики выполнения. В будущем будет удобнее читать код и самому и остальным
А в случае простых доработок можно обойтись и просто идентификацией (когда, кем, для какой задачи сделано)