![](https://habrastorage.org/getpro/habr/upload_files/607/858/b22/607858b22ca82be827cd475eb2c870db.png)
Написанием кода занимается далеко не один разработчик, это совместная работа нескольких команд, а порой и целых подразделений (и это еще не упоминая о смене кадров). Код может жить в компании годами и переиспользоваться в новых продуктах.
По этим причинам важно, чтобы любой кусок кода, который может вызвать вопросы у стороннего читателя, был объяснен его автором. Для этого разработчики оставляют в коде комментарии. Как правило, они абсолютно безвредны для кода, почти незаметны и никак не влияют на компиляцию.
При этом комментарии помогают не только сохранить знания внутри компании, упростить понимание кода и намного быстрее производить дебаггинг, но и порой просто повеселить его читателя.
Под катом собрали и пояснили 13 примеров полезных и забавных комментариев, которые оставили наши коллеги в исходниках продуктов Content AI.
![](https://habrastorage.org/getpro/habr/upload_files/165/ec7/858/165ec7858dd37f6f0c002b5509fffebe.png)
Оговариваем ожидание статуса задачи
![](https://habrastorage.org/getpro/habr/upload_files/0d5/87a/eeb/0d587aeeb1bf082e312161fc21e68cd2.png)
Поясняем, почему выбрано именно такое решение для связи разных модулей в коде
![](https://habrastorage.org/getpro/habr/upload_files/099/259/53c/09925953c6abc5fa0a0b79416efcd6ee.png)
Уточняем про Race condition в списке задач при обработке документов
![](https://habrastorage.org/getpro/habr/upload_files/ad5/cf6/d51/ad5cf6d51f1a5da9e2321cf17352464f.png)
Говорим про парсинг ответа сервиса обработки документов
![](https://habrastorage.org/getpro/habr/upload_files/ced/3ac/deb/ced3acdeb8e2f3aa1bbdac168584e976.png)
Уточняем про парсинг ответа Active Directory
![](https://habrastorage.org/getpro/habr/upload_files/523/7e4/64a/5237e464a79eefa5f1c07cbdc037d945.png)
Поясняем хитрое извлечение параметров регулярного выражения через рефлекшн
![](https://habrastorage.org/getpro/habr/upload_files/10e/b30/2ee/10eb302ee9baa780dba21cb4b817ff79.png)
Объясняем, что сейчас произойдет в коде
![](https://habrastorage.org/getpro/habr/upload_files/8ee/c01/fcc/8eec01fcc194172d9018aa71ed2ac8c3.png)
Уточняем размер батча задач при обработке документов, используя аллюзию на слова Билла Гейтса про то, что «640 КБ должно хватить всем»
![](https://habrastorage.org/getpro/habr/upload_files/cec/d6f/ae0/cecd6fae08d6754bd5ebfce35493b7c7.png)
Рассказываем про ветку транслятора запросов из пользовательского языка запросов в язык запросов ElasticSearch в случае отсутствия пользовательского словаря синонимов
![](https://habrastorage.org/getpro/habr/upload_files/5f4/aca/b11/5f4acab119edf29191dcce883d634384.png)
Соглашаемся, что это ту мач
![](https://habrastorage.org/getpro/habr/upload_files/bde/3f1/ed0/bde3f1ed0081f082aeabc25ca8b82464.png)
Когда код передавался заказчику, его перевели на английский язык, тем самым изменив «предназначение» – теперь он был написан во имя «славы»: This code was specifically written for glory
![](https://habrastorage.org/getpro/habr/upload_files/f00/97e/7f4/f0097e7f48a6b1179ce468e39de725cf.png)
Речь о коде «аварийной» кодировки в PDF. Под «*опой» имелся в виду «аварийный» вариант развития событий
![](https://habrastorage.org/getpro/habr/upload_files/2a3/359/b67/2a3359b67731e906e8642c6f9373e28f.png)
Прим. редакции: этот комментарий показался нам самым смешным.
NB! Мнение непросвещенной редакции может не совпадать с мнением разработчиков.
Делитесь в комментариях своими нужными или смешными пасхалками в коде.