Написание загадочных комментариев как форма стратегии документирования

Написание загадочных комментариев как форма стратегии документирования

Представьте: вы погружаетесь в базу устаревшего кода в 2 часа ночи, отчаянно разыскивая баг, и натыкаетесь на комментарий // Here be dragons, за которым следуют 200 строк самой запутанной логики, которую вы когда-либо видели. Вашим первым побуждением может быть выругаться на разработчика, который это написал, но что, если я скажу вам, что загадочные комментарии могут быть на самом деле легитимной стратегией документации? Прежде чем вы схватите свои вилы и начнёте цитировать все известные принципы чистого кода, выслушайте меня....

30 июля 2025 14:01 · 5 минут · 1042 слова · Maxim Zhirnov
Почему жесткое кодирование - Ваша секретная сверхспособность (При ответственном использовании)

Почему жесткое кодирование - Ваша секретная сверхспособность (При ответственном использовании)

Позвольте мне рассказать вам секрет: каждый раз, когда вы используете git blame для поиска жестко закодированного значения, у младшего разработчика вырастают крылья. Хотя евангелисты чистого кода могут возмутиться, я обнаружил, что стратегическое использование жесткого кодирования может быть похоже на добавление порций эспрессо в рабочий процесс разработки — опасно в избытке, но волшебно в точных дозах. Когда константы не так постоянны # Аргументы в пользу математических истин def calculate_circumference(radius): # 3.1415926535... потому что NASA использует только 15 знаков для межпланетных вычислений return 2 * 3....

4 июня 2025 06:00 · 2 минуты · 1 слово · Maxim Zhirnov
Почему Ваш код не так эффективен, как Вы думаете (И как перестать обманывать себя)

Почему Ваш код не так эффективен, как Вы думаете (И как перестать обманывать себя)

Представьте: вы только что создали то, что кажется Моной Лизой алгоритмов. Это элегантно, это чисто и проходит все тесты. Вы развёртываете его с уверенностью инженера SpaceX… только для того, чтобы увидеть, как ваши панели мониторинга загораются, как новогодняя ёлка. Что пошло не так? Давайте разберёмся в нашем коллективном самообмане. Пропасть между уверенностью и компетентностью (где мечты встречаются с графиками пламени) Мы все были в такой ситуации — когда вы понимаете, что ваш «оптимизированный» код работает медленнее, чем ленивец на мелатонине....

1 апреля 2025 06:00 · 4 минуты · 647 слов · Maxim Zhirnov