Здравствуйте, paucity, Вы писали:
vsb>>Избавить читателя от необходимости чтения кода. Я в последнее время внедряю концепцию, когда код дублируется в комментарии, если комментарий прочитать проще, чем понимать код.
P>Странно, ты прокомментировал совершенно понятный, даже для не-программиста, IF и совершенно не прокомментировал чуточку более "сложный" ELSE.
Ну в else там идёт стандартная форма логгинга, что её комментировать. По сути когда ты пишешь DEBUG(x) то он напишет в лог x: 123. Но если ты напишешь DEBUG("preparing"), то он напишет не preparing: "preparing", а просто preparing. Предполагается, что если человек полез в этот код, то лог он хоть раз запускал и форму вида x: 123 видел, поэтому к этому коду вопросов возникнуть вроде как не должно. А зачем нужен этот if — ну мне не очевидно было бы сходу.
По-моему это не существенно. Я согласен, что возможно это слишком очевидный комментарий. Суть же не в том, насколько он очевидный, а в том, что ИИ смог распознать этот паттерн и сгенерировать этот комментарий.