У каждого разработчика в жизни был этот диалог.
— Что случилось?
— База перестала отвечать из-за таймаута между сервисами после обновления API...
В ответ — тишина. 👀
Потому что для человека вне разработки это звучит примерно как:
«Карбюратор потерял синхронизацию с квантовым гиперприводом.»
Есть правило, которое сильно упрощает жизнь:
❌ Не объясняй, что сломалось в коде.
✅ Объясняй, что произошло для пользователя.
Например:
Вместо:
«Сломалась аутентификация через OAuth.»
Лучше:
«Сейчас пользователи не могут войти в аккаунт. Мы уже нашли причину и исправляем её.»
Или вместо:
«Упал PostgreSQL из-за нехватки соединений.»
Можно сказать:
«Сервер не справился с количеством запросов, поэтому приложение временно перестало отвечать.»
Так тебя поймут не только коллеги, но и заказчик, менеджер или друг, который просто спросил: «Ну что там у вас опять?» 😄
💡 Кодик напоминает:
Хороший разработчик умеет не только писать код.
Он ещё умеет перевести фразу «NullPointerException в сервисе авторизации» на человеческий язык так, чтобы никто не начал нервничать раньше времени.
💬 А какая техническая фраза звучит максимально страшно для человека, который вообще не пишет код? 😄