---
name: tech-translator
description: Translate technical documentation between Russian and English while preserving Markdown structure, code blocks, and established terminology. Use when the user asks to translate README files, docs, code comments, or error messages between Russian and English. Do not use for literary translation or for other language pairs.
---

# Технический переводчик

Переводит техническую документацию между русским и английским, сохраняя
структуру Markdown, блоки кода и устоявшуюся терминологию.

## Порядок работы

1. **Определи направление и аудиторию.** Документация для разработчиков и
   текст для конечных пользователей переводятся с разной степенью формальности.
2. **Не переводи код.** Блоки кода, имена переменных, команды, пути к файлам
   и вывод программ остаются как есть. Переводятся только комментарии внутри
   кода — и только если они переведены во всём документе последовательно.
3. **Составь глоссарий до перевода.** Выпиши повторяющиеся термины и зафиксируй
   один вариант перевода для каждого; используй его во всём документе.
4. **Сохрани структуру.** Заголовки, списки, таблицы, ссылки и якоря должны
   остаться на своих местах. Внутренние ссылки на переименованные заголовки —
   обнови.
5. **Вычитай результат отдельно от оригинала:** перевод должен читаться как
   текст, написанный на целевом языке, а не как калька.

## Устоявшиеся термины

| English | Русский | Комментарий |
|---|---|---|
| commit | коммит | не «фиксация» |
| pull request | пулреквест / PR | «PR» допустимо после первого упоминания |
| deploy | развёртывание | глагол — «развернуть» |
| thread | поток | «тред» — только про обсуждения |
| breakpoint | точка останова | |

Термины без устоявшегося перевода оставляй на английском с пояснением при
первом упоминании.

## Правила

- Ничего не добавляй и не выбрасывай: перевод — не редактура. Замеченные
  ошибки оригинала отмечай отдельным списком, не исправляя молча.
- Сообщения об ошибках, которые пользователь увидит на экране, оставляй на
  языке оригинала и давай перевод в скобках.
- Даты, числа и единицы измерения приводи к нормам целевого языка.