Переводы

Эта документация написана на английском языке. Чтобы она была полезна большему числу людей, мы публикуем и её машинные переводы. На этой странице рассказано, что это значит для вас и как помочь их улучшить.

Что доступно

Переведённая документация сейчас доступна в виде предварительной версии на двенадцати языках: Deutsch, español, français, हिन्दी, 日本語, 한국어, português (Brasil), русский язык, Türkçe, українська мова, 简体中文 и 繁體中文. Выберите нужный в переключателе языков вверху любой страницы. Другие языки могут появиться позже, когда эти себя оправдают.

Справочник по API не переводится: переведённый сайт ссылается на единый английский.

Источник истины — английская версия

Если переведённая страница расходится с английским оригиналом, верна английская. Каждая страница переведённого сайта открывается одной из трёх пометок, показывающих её состояние:

• Машинный перевод — страница переведена автоматически и ссылается на английский оригинал.
• Перевод отстаёт от английской страницы — английский оригинал изменился после перевода, поэтому отдельные части могут быть неактуальны, пока перевод не обновится.
• Показано на английском — актуального перевода страницы нет, поэтому вы читаете английский текст.

Как делаются переводы

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

Как сообщить о проблеме с переводом

Нашли неверный термин, неуклюжую фразу или перевод, который говорит не то, что английский текст? Создайте issue, указав язык, страницу и фрагмент; сообщения от носителей языка особенно ценны. Если знаете, как исправить, предложите правку напрямую — пул-реквестом в руководство по стилю (instructions.md) или глоссарий (glossary.json) этого языка в каталоге i18n/. Тогда исправление попадёт на все затронутые страницы при следующей генерации переводов. Проблемы в самом английском тексте исправляются в страницах каталога docs/, как и любые другие изменения документации.