Иногда комментарии реально помогают разобраться в коде. А иногда это просто боль.
Ниже мой персональный рейтинг. Впрочем, скорее, не рейтинг, а список, потому что любой из этих комментов заслуживает первого места.
// TODO: разобратьсяХочется спросить: ты сейчас с кем разговариваешь? С будущим собой? С джуном? С преемником?
Разобраться в чём? Почему не сейчас? И кто должен разбираться?
// ВременноСколько боли в этом слове. Особенно, если коммиту уже 3 года.
Нет ничего более постоянного, чем временное.
// Не спрашивайте почемуНу а теперь мы точно будем спрашивать. Потому что там либо гениальный хак, либо техдолг размером с ИТ-бюджет области.
// Здесь должна быть проверка…Но её нет.
Может, ты надеялся, что её кто-то другой напишет? Или проверка сама себя создаст?
// Ужас, но по-другому не получилосьПрямо хочется обнять.
Но лучше бы ты написал, почему не получилось. Или хотя бы оставил ссылку на issue, где объяснил, что именно ужасного ты тут натворил.
А теперь сеанс саморазоблачения.
Все эти комментарии я взял из своих собственных коммитов.
Но почему-то, в момент, когда я их оставлял, мне они не казались столь абсурдными...
Но теперь вы посмеялись надо мной и точно не будете так делать.
Правда ведь?🥸