Почему комментарии должны быть загадками: Дерзкое руководство по зашифрованной документации
Искусство говорить на языке кода Позвольте мне признаться кое в чём: однажды я написал комментарий, который просто гласил «// ФИКСИРУЕМ: Помогите!» рядом с алгоритмом сортировки. Три года спустя я нашёл свою собственную нацарапанную просьбу и понял, что создал программный эквивалент древней шумерской таблички. Так, дорогой читатель, я стал случайным пионером стратегической документации по обфускации. Загадочные комментарии — это не ошибки, а функции, маскирующиеся под философские коаны. Позвольте показать вам, как использовать двусмысленность со стилем....