Перевод

Перевод не обязательно должен быть слово-в-слово.

Он должен быть без ошибок и, по сути, верным, хорошо объясняющим.

Если вы видите, что исходный текст может быть улучшен – отлично, пришлите, пожалуйста, PR.

Важно!

Сохраняйте переносы строк (пустые строки) и структуру абзацев «как есть»: это упрощает объединение будущих изменений из английской версии в перевод.

Текст в коде

Комментарии в коде – переводить.
Строки в примерах – можно переводить, но не обязательно.
Названия переменных, классы, идентификаторы – не надо переводить.

Например:

// Example
const text = "Hello, world";
document.querySelector('.hello').innerHTML = text;

✅ ХОРОШО (переведён комментарий):

// Пример
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;

✅ ТОЖЕ ОК (переведён комментарий и текст):

// Пример
const text = 'Привет, мир';
document.querySelector('.hello').innerHTML = text;

Внешние ссылки

Если есть внешняя ссылка на MDN или Wikipedia, например https://en.wikipedia.org/wiki/JavaScript, но есть версия этой же статьи на русском, поменяйте ссылку.

Например:

[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.

✅ ПОСЛЕ ЗАМЕНЫ (en -> ru):

[JavaScript](https://ru.wikipedia.org/wiki/JavaScript) – это язык программирования.

Если статья на MDN переведена частично, это тоже подходит.

В случае, если у ссылки нет эквивалента на русском, оставьте её как есть.

И ещё пара деталей :)

Вы и его производные пишите с маленькой буквы
Используйте букву ё (этот npm-пакет может проверить текст и вставить её, где нужно)
Не знаете, как перевести термин? Словарь «Веб-стандартов» поможет!
Названия компаний (Google), библиотек (Jest) и аббревиатуры (DOM) не переводятся.
importance: n встречающееся в начале задач - служебное поле, перевод не требуется.

Соглашение по переводу (глоссарий)

Пожалуйста, поддерживайте глоссарий в алфавитном порядке.

Оригинальный термин	Перевод
Arrow function	Стрелочная функция
Backtick	Обратная кавычка
Bitwise operator	Побитовый оператор
Breakpoint	Точка останова
Character class	Символьный класс
Comparison	Операция сравнения
Construct	Конструкция
Conversion	Конвертирование
Functionality	Функциональность
Left click/right click	Левый/правый клик? Кликните? левой кнопкой мыши
More in / Details in	Подробнее в
Script	Скрипт
Statement	Инструкция
Summary	Итого

Ресурсы по переводу

Чтобы улучшить ваш перевод и, вообще, письмо, полезные статьи:

Берегись канцелярита!
Словесная алгебра
Поиск переводов в контексте
DeepL - переводчик на нейросетях

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!