translation

Author: iliakan

TRANSLATION.md

@@ -1,94 +1,69 @@
-# Русский перевод The JavaScript Tutorial
+# Перевод
 
-Репозиторий содержит переведенные файлы на русский язык сайта [Modern JavaScript Tutorial](https://javascript.info).
+Перевод не обязательно должен быть слово-в-слово.
 
-<!--
-Текущий прогресс: 
-Пожалуйста, используйте этот ишью, если вы хотите что-то перевести и узнать.
---> 
+Он должен быть без ошибок и, по сути, верным, хорошо объясняющим.
 
-По вопросам перевода обращайтесь к @iliakan.
+Если вы видите, что исходный текст может быть улучшен – отлично, пришлите, пожалуйста, PR.
 
-## Общие правила
+## Текст в коде
 
-- Перевод не должен быть буквальным, избегайте кальки. Небольшие вольности в переводе допускаются, но только если они помогают передать смысл.
-- Перевод должен быть технически правильным и хорошо написанным.
-- Если вам нужно оригинальный текст, отправьте пулреквест в соответствующий репозиторий.
-- _Вы_ и его производные пишите с маленькой буквы
-- Всегда используйте букву `ё` (это легко соблюдать с помощью [данного npm-пакета](https://github.com/hcodes/eyo))
-- Используйте тире вместо дефиса (оно должно быть намного длиннее, чем дефис). Тире: `—`, дефис: `-`
-- Переводите комментарии в примерах кода, но не содержимое
-- Используйте терминологию [словаря «Веб-стандартов»](https://github.com/web-standards-ru/dictionary), если нет исходного варианта в таблице ниже
-- Не переводите наименования компаний (Facebook, Airbnb), библиотек (Jest, Enzyme) и т.д.
-- Не переводите аббревиатуры (API, DOM, HOC, UI).
-
-### Ресурсы по переводу
-
-Для лучшего перевода, пожалуста, ознакомьтесь со следующими статьями:
-
-* [Берегись канцелярита!](http://www.vavilon.ru/noragal/slovo2.html)
-* [Словесная алгебра](http://www.vavilon.ru/noragal/slovo4.html)
+- Комментарии в коде – переводить.
+- Строки в примерах – можно переводить, но не обязательно.
+- Названия переменных, классы, идентификаторы – не надо переводить.
 
-## Универсальное руководство по стилю
-
-Описанные ниже правила содержаться в [оригинальном репозитории](https://github.com/javascript-tutorial/en.javascript.info/blob/master/TRANSLATION.md), который предписывает общий стиль для **всех** языков, на которые переводится учебник.
-
-## Текст в блоках с кодом
-
-- Переводите комментарии в блоках кода.
-- По возможности переводите строки в примерах.
-- Не переводите имя переменных, идентификаторов, классов.
-
-Пример:
+Например:
 
 ```js
 // Example
 const text = "Hello, world";
 document.querySelector('.hello').innerHTML = text;
 ```
 
-✅ МОЖНО (переведён комментарий):
+✅ ХОРОШО (переведен комментарий):
 
 ```js
-// Ejemplo
+// Пример
 const text = 'Hello, world';
 document.querySelector('.hello').innerHTML = text;
 ```
 
-✅ ТОЖЕ МОЖНО (переведён ещё текст):
+✅ ТОЖЕ ОК (переведен комментарий и текст):
 
 ```js
-// Ejemplo
-const text = 'Hola mundo';
+// Пример
+const text = 'Привет, мир';
 document.querySelector('.hello').innerHTML = text;
 ```
 
-❌ НЕЛЬЗЯ (переведён класс):
 
-```js
-// Ejemplo
-const text = 'Hola mundo';
-// ".hello" is a class
-// DO NOT TRANSLATE
-document.querySelector('.hola').innerHTML = text;
+## Внешние ссылки
+
+Если есть внешняя ссылка на MDN или Wikipedia, например https://en.wikipedia.org/wiki/JavaScript, но есть версия этой же статьи на русском, поменяйте ссылку.
+
+Например:
+
+```md
+[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
 ```
 
-❌ СОВСЕМ НЕЛЬЗЯ (переведены переменные):
+✅ ПОСЛЕ ЗАМЕНЫ (en -> ru):
 
-```js
-// Ejemplo
-const texto = 'Hola mundo';
-documento.querySelector('.hola').interiorHTML = texto;
+```md
+[JavaScript](https://ru.wikipedia.org/wiki/JavaScript) – это язык программирования.
 ```
 
-### Внешние ссылки
+Если статья на MDN переведена частично, это тоже подходит.
 
-Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia], и там существует статья на русском языке, исправьте ссылку, чтобы она указывала на русский вариант, даже если он неполный или требует улучшения.
+В случае, если у ссылки нет эквивалента на русском, оставьте её как есть.
 
-[MDN]: https://developer.mozilla.org/en-US/
-[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page
+## И ещё пара деталей :)
+
+- _Вы_ и его производные пишите с маленькой буквы
+- Используйте букву `ё` ([этот npm-пакет](https://github.com/hcodes/eyo) может проверить текст и вставить её, где нужно)
+- Не знаете, как перевести термин? [Соварь «Веб-стандартов»](https://github.com/web-standards-ru/dictionary/blob/master/dictionary.md) поможет!
+- Названия компаний (Google), библиотек (Jest) и аббревиатуры (DOM) не переводятся.
 
-Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть.
 
 <!-- скоро
 
@@ -100,3 +75,11 @@ documento.querySelector('.hola').interiorHTML = texto;
 | ------------------ | ---------- |
 
 -->
+
+
+## Ресурсы по переводу
+
+Чтобы улучшить ваш перевод и, вообще, письмо, полезные статьи:
+
+* [Берегись канцелярита!](http://www.vavilon.ru/noragal/slovo2.html)
+* [Словесная алгебра](http://www.vavilon.ru/noragal/slovo4.html)