TGViewer
🤓Бартов: про работу с ИТ- и медтекстами и про всякое 🤓Бартов: про работу с ИТ- и медтекстами и про всякое @alliancepro · 2.43K subscribers
Post #3874 428
Про локализацию кода в стайлгайдах ИТ-компаний написано скупо. И то, что написано, мягко говоря, не учитывает массу edge cases.

Темы локализации промптов там нет вообще. А я на эти грабли наступил — когда переводил книгу Томажа Братанича «Основы GraphRAG. Улучшенный RAG на базе графов знаний».
Подробно про ту проблематику я сейчас расписывать не буду. Косвенно я её упомянул в телеграм-группе «Дебагеры Read IT Club» . Вот цитата:
Под листингами я понимаю следующие вещи:
1. Фрагменты кода / результаты его выполнения. 2. Логи/выводы команд. 3. Промпты/инференсы/выводы (в т.ч. системные и для взаимодействия с MCP). 4. Сообщения об ошибках.

Может, ещё что-то забыл — пожалуйста, дополните. Но, думаю, направление мыслей понятно.

С одной стороны, нельзя оставлять читателя без перевода — ему может быть непонятно.
С другой стороны, переводить даже значения строковых переменных опасно. Вдруг автору захочется посчитать в них слова, буквы или байты, отсортировать их или использовать строковые значения в качестве заголовков полей в БД (типа orders). Плюс нельзя упускать из виду такой момент: если вы в первой главе что-то перевели по определённому паттерну, то и до конца книги придётся переводить так же. Или не переводить вообще.

С промптами тоже всё неоднозначно. То, что прекрасно работает на английском в одной модели, может работать совсем не так — или совсем никак — на русском в этой же модели. И уж тем более в другой: мало ли на каких тренировочных сетах они выращивались.

С выводами выполнения команд тоже непросто. Вроде как там можно перевести, но надо, видимо, какое-то предупреждение для читателя выводить: этот перевод понарошку, в реальности он всё равно увидит на экране английские слова. Потому что этот шелл, справка или утилита на русский никогда не переводились — и вряд ли кому захочется оплачивать такой перевод.

•••
Жарких дискуссий мой вопрос не вызвал. Но сейчас я уже заканчиваю работу над переводом книги Go In Action, и мне этот вопрос надо было как-то решать.


Получившееся решение см. на https://teletype.in/@bartov/9nZNs_UyiBl
  • ❤ 3
  • 👏 3
More from @alliancepro
  1. Oct 14, 2026У меня первый язык - немецкий. Поэтому я именно так сначала английский и учил.
  2. Oct 7, 2026Кстати, когда мы обсуждали заказ на перевод книги по теории информации, клиент предложил м…
  3. Oct 7, 2026Пара терминов из математики вам в копилку + занимательный ребус. https://teletype.in/@bart…
  4. Oct 6, 2026Как и обещал, написали для клиента статью о том, почему дешевый ИИ на самом деле весьма до…
  5. Oct 1, 2026Можно зафиксировать небольшой личный рекорд: ~570 страниц за сентябрь.
  6. Sep 30, 2026Переведенная мною книга уже появилась на пиратских развалах (обнаружил в свежем пополнении…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →