From 246748285ca3d81162b7c6f457de2d41113ca93a Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Mon, 15 Mar 2021 16:33:17 +0300 Subject: Add initial style guide for Russian translation --- docs/ru/translation-guide.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/ru/translation-guide.md diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md new file mode 100644 index 0000000000..f477885041 --- /dev/null +++ b/docs/ru/translation-guide.md @@ -0,0 +1,26 @@ +# Участие в переводе + +Для начала ознакомьтесь с [общими правилами](https://developer.mozilla.org/en-US/docs/MDN/Guidelines), в частности, со страницей "Writing style guide". + +## Рекомендации по переводу + +- _Вы_ и его производные пишите с маленькой буквы +- Всегда используйте букву `ё` +- Используйте тире вместо дефиса (оно должно быть намного длиннее, чем дефис). Тире: `—`, дефис: `-` +- Используйте терминологию [словаря «Веб-стандартов»](https://github.com/web-standards-ru/dictionary), а также сверяйтесь с глоссарием ниже +- При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком) +- Не переводите названий компаний, библиотек и т.д. +- Не переводите аббревиатуры (API, DOM, UI) +- Названия статей и заголовки пишите с одной заглавной буквы +- Переводите комментарии в примерах кода, но не содержимое + +## Глоссарий + +**Пожалуйста, поддерживайте глоссарий в алфавитном порядке.** + +| Оригинальный термин | Перевод | +| ------------------ | ---------- | +| cache | кеш | +| feature | возможность (*менее предпочтительный синоним: функциональность*) | +| production | продакшен | +| render(ing) | рендер, рендерить, отрендерить | -- cgit v1.2.3-54-g00ecf From 201284a28b7873e37548c2d7190fbfbcf63e3435 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Tue, 16 Mar 2021 00:22:06 +0300 Subject: Apply suggestions from code review Co-authored-by: Alexander Myshov --- docs/ru/translation-guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md index f477885041..612cee044f 100644 --- a/docs/ru/translation-guide.md +++ b/docs/ru/translation-guide.md @@ -1,6 +1,6 @@ # Участие в переводе -Для начала ознакомьтесь с [общими правилами](https://developer.mozilla.org/en-US/docs/MDN/Guidelines), в частности, со страницей "Writing style guide". +Для начала ознакомьтесь с [общими правилами](https://developer.mozilla.org/en-US/docs/MDN/Guidelines), в частности, со страницей ["Writing style guide"](https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide). ## Рекомендации по переводу @@ -9,7 +9,7 @@ - Используйте тире вместо дефиса (оно должно быть намного длиннее, чем дефис). Тире: `—`, дефис: `-` - Используйте терминологию [словаря «Веб-стандартов»](https://github.com/web-standards-ru/dictionary), а также сверяйтесь с глоссарием ниже - При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком) -- Не переводите названий компаний, библиотек и т.д. +- Не переводите названия компаний, библиотек и т.д. - Не переводите аббревиатуры (API, DOM, UI) - Названия статей и заголовки пишите с одной заглавной буквы - Переводите комментарии в примерах кода, но не содержимое -- cgit v1.2.3-54-g00ecf From 7990e2f751bfdb927043f57bc0a0813644c26d3f Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Tue, 16 Mar 2021 00:22:21 +0300 Subject: Update translation-guide.md --- docs/ru/translation-guide.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md index 612cee044f..9bfbe9a268 100644 --- a/docs/ru/translation-guide.md +++ b/docs/ru/translation-guide.md @@ -12,7 +12,6 @@ - Не переводите названия компаний, библиотек и т.д. - Не переводите аббревиатуры (API, DOM, UI) - Названия статей и заголовки пишите с одной заглавной буквы -- Переводите комментарии в примерах кода, но не содержимое ## Глоссарий -- cgit v1.2.3-54-g00ecf From d4df0934dd7f660ff9c5bc7460693c75402e564b Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Tue, 16 Mar 2021 01:22:41 +0300 Subject: Update translation-guide.md --- docs/ru/translation-guide.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md index 9bfbe9a268..1bad0ce319 100644 --- a/docs/ru/translation-guide.md +++ b/docs/ru/translation-guide.md @@ -7,6 +7,8 @@ - _Вы_ и его производные пишите с маленькой буквы - Всегда используйте букву `ё` - Используйте тире вместо дефиса (оно должно быть намного длиннее, чем дефис). Тире: `—`, дефис: `-` +- Используйте кавычки-ёлочки («»), за исключением примеров кода +- Переводите примеры кода (как комментарии, так и вывод), за исключением ошибок - Используйте терминологию [словаря «Веб-стандартов»](https://github.com/web-standards-ru/dictionary), а также сверяйтесь с глоссарием ниже - При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком) - Не переводите названия компаний, библиотек и т.д. -- cgit v1.2.3-54-g00ecf From 6745d331e083a173c8c6951e81e806a690ddb91e Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Tue, 16 Mar 2021 01:57:41 +0300 Subject: Update translation-guide.md --- docs/ru/translation-guide.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md index 1bad0ce319..7b12256b6c 100644 --- a/docs/ru/translation-guide.md +++ b/docs/ru/translation-guide.md @@ -13,6 +13,7 @@ - При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком) - Не переводите названия компаний, библиотек и т.д. - Не переводите аббревиатуры (API, DOM, UI) +- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (URL'ы -> URL-адреса) - Названия статей и заголовки пишите с одной заглавной буквы ## Глоссарий -- cgit v1.2.3-54-g00ecf