Английская документация: читать оригинал, не переводить полотно

Типичный день разработчика или аналитика: открыт не учебник, а страница, без которой не закрыть задачу. MDN, Kubernetes, AWS, внутренний Confluence на английском, issue на GitHub, RFC. Текст смешан с идентификаторами. Если включить перевод страницы, fetch превращается в «получить», имена заголовков плывут, куски кода становятся невалидными. Вы тратите время на обратный перевод того, что и так должно остаться английским.

WordPop здесь уместен не потому, что «лучший для программистов», а потому что не трогает полотно. Клик по слову в абзаце, карточка, страница как была. Это другая работа, чем Immersive Translate или встроенный перевод Яндекс.Браузера. Тем и полезна.

Какие слова сохранять из доков

Не все. Глаголы вроде provide и however вы и так встретите сотню раз; колода от них раздувается. Имеет смысл то, что всплывает в вашей предметной области и без чего вы спотыкаетесь в новом гайде: throughput, idempotent, backoff, lease, stale, handshake. Правило то же, что в общем методе слов с сайтов: в колоду — то, что встретится снова или стоит помнить. Разовый жаргон тикета — достаточно карточки без звезды.

Имена API, классов и заголовков часто не нужно «учить как слово». Их нужно узнать в лицо в этом репозитории. Если лемматизатор превратит PreconditionFailed во что-то общее — не сохраняйте, оставьте как поиск по доке. Lemma — про словарные слова, не про каждый идентификатор. Определение — в глоссарии.

Почему перевод страницы в доках особенно вреден

В художественном тексте ошибочный перевод раздражает. В документации он врёт про поведение системы. «Eventually consistent» и «в конечном счёте согласованный» — ещё полбеды. Хуже, когда машинный перевод переставляет отрицание или путает may / must в RFC. Оригинал плюс одно уточнённое слово безопаснее, чем гладкий русский абзац с другим модальным оттенком.

Отсюда практическое правило: переводчик полотна — на письмо заказчику и на новость. Документация продукта, которым вы пользуетесь руками, — оригинал. Если абзац совсем не идёт, переведите этот абзац в Яндекс.Переводчике или Google, не всю страницу, и вернитесь к английскому.

Как встроить это в рабочий день

1. Поставить WordPop из Chrome Web Store в том браузере, где вы читаете доки.
2. Отключить автоперевод для доменов документации, если браузер его навязывает.
3. Читать как обычно. Кликать только то, на чём реально остановились.
4. Звездой — три–семь слов за день, не главу целиком.
5. В конце дня открыть панель повторений на 5–10 минут. Если не открываете — меньше звёзд завтра.

Это скучный ритуал, и в этом его сила. Документация и так каждый день. Словарь не должен становиться отдельным «уроком английского». Если хочется урок — это Skyeng или учебник, не расширение. Если хочется большую колоду с шаблонами — Anki, WordPop может только поставлять сырьё через TSV/CSV.

Что не обещаем разработчикам

Нет режима «перевести только комментарии, код не трогать» — нам нечего переводить полотном. Нет подсветки всех незнакомых слов сразу: это шумно и почти всегда врёт про то, что вы «не знаете». Нет общих колод «английский для Middle». Нет обещания, что карточка знает ваш внутренний жаргон команды: для этого есть контекст предложения и, по желанию, свой API-ключ на уточнение.

Нет и отдельного «WordPop for GitHub». Одна карточка на любых вкладках. Отдельные URL вида «словарь для MDN / для Stack Overflow» мы не плодим: текст был бы одним и тем же. Этот сценарий — про документацию как тип чтения, не про каталог сайтов.

Командные доки и внутренний жаргон

Во внутреннем Confluence часто смесь нормального английского и изобретённых аббревиатур. Карточка хорошо закрывает первое и честно бесполезна для второго: SPOF вашей команды Wiktionary не знает так, как знает дежурный. Не пытайтесь строить корпоративный глоссарий из WordPop. Для своих терминов — вики команды. Для английских слов вокруг них — звезда.

То же с код-ревью в браузере: комментарии на английском — да, идентификаторы в диффе — нет. Если кликаете по имени функции и удивляетесь переводу, это ожидаемо. Расширение думает, что перед ним слово языка, а перед ним символ программы.

Если документация всё же не читается

Иногда проблема не в словах, а в уровне. Тогда нужен курс или регулярное чтение проще, чем сразу Kubernetes. WordPop не поднимет вас с A2 до чтения RFC за неделю. Он снимает трение, когда чтение уже происходит. Честный тест — один спринт: доки как обычно, клики по факту, вечерние карточки. Если колода пустая, а боль осталась — боль в другом месте: в архитектуре, в нехватке сна, в том, что текст просто плохой.

Имеет смысл тогда упростить вход: сначала гайды с большим числом примеров кода и меньшим объёмом прозы, параллельно короткий курс или Anki на базовую лексику CS, и только потом возвращаться к RFC. WordPop на этом этапе может стоять, но не обязан спасать. Он хорошо работает, когда чтение уже происходит каждый день.