Про локализацию кода в стайлгайдах ИТ-компаний написано скупо. И то, что написано, мягк... — 1 октября 2026 г. в 17:53:04.849
Про локализацию кода в стайлгайдах ИТ-компаний написано скупо. И то, что написано, мягко говоря, не учитывает массу edge cases. Темы локализации промптов там нет вообще. А я на эти грабли наступил — когда переводил книгу Томажа Братанича «Основы GraphRAG. Улучшенный RAG на базе графов знаний» (https://www.piter.com/product/osnovy-graphrag-uluchshennyy-rag-na-baze-grafov-znaniy). Подробно про ту проблематику я сейчас расписывать не буду. Косвенно я её упомянул в телеграм-группе «Дебагеры Read IT Club» (https://t.me/c/3728779175/5/399) . Вот цитата: Под листингами я понимаю следующие вещи: 1. Фрагменты кода / результаты его выполнения. 2. Логи/выводы команд. 3. Промпты/инференсы/выводы (в т.ч. системные и для взаимодействия с MCP). 4. Сообщения об ошибках. Может, ещё что-то забыл — пожалуйста, дополните. Но, думаю, направление мыслей понятно. С одной стороны, нельзя оставлять читателя без перевода — ему может быть непонятно. С другой стороны, переводить даже значения строковых переменных опасно. Вдруг автору захочется посчитать в них слова, буквы или байты, отсортировать их или использовать строковые значения в качестве заголовков полей в БД (типа orders). Плюс нельзя упускать из виду такой момент: если вы в первой главе что-то перевели по определённому паттерну, то и до конца книги придётся переводить так же. Или не переводить вообще. С промптами тоже всё неоднозначно. То, что прекрасно работает на английском в одной модели, может работать совсем не так — или совсем никак — на русском в этой же модели. И уж тем более в другой: мало ли на каких тренировочных сетах они выращивались. С выводами выполнения команд тоже непросто. Вроде как там можно перевести, но надо, видимо, какое-то предупреждение для читателя выводить: этот перевод понарошку, в реальности он всё равно увидит на экране английские слова. Потому что этот шелл, справка или утилита на русский никогда не переводились — и вряд ли кому захочется оплачивать такой перевод. ••• Жарких дискуссий мой вопрос не вызвал. Но сейчас я уже заканчиваю работу над переводом книги Go In Action (https://codelibs.ru/media/books/go-in-action-2-ed.pdf), и мне этот вопрос надо было как-то решать. Получившееся решение см. на https://teletype.in/@bartov/9nZNs_UyiBl