diff options
| author | Chris Mills <cmills@mozilla.com> | 2021-03-17 18:08:52 +0000 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-03-17 18:08:52 +0000 |
| commit | a72bb39e55e6c7f06df3ea8f6f7286f9a4a93d10 (patch) | |
| tree | 5e495dcf4a839bb0816e3a8b494c456bd5bd2786 | |
| parent | 345a60f5f0aa29f65bd0e13aee7f55870f4a92c2 (diff) | |
| parent | 6745d331e083a173c8c6951e81e806a690ddb91e (diff) | |
| download | translated-content-a72bb39e55e6c7f06df3ea8f6f7286f9a4a93d10.tar.gz translated-content-a72bb39e55e6c7f06df3ea8f6f7286f9a4a93d10.tar.bz2 translated-content-a72bb39e55e6c7f06df3ea8f6f7286f9a4a93d10.zip | |
Merge pull request #177 from mdn/lex111/ru-style-guide
Add initial style guide for Russian translation
| -rw-r--r-- | docs/ru/translation-guide.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md new file mode 100644 index 0000000000..7b12256b6c --- /dev/null +++ b/docs/ru/translation-guide.md @@ -0,0 +1,28 @@ +# Участие в переводе + +Для начала ознакомьтесь с [общими правилами](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://github.com/web-standards-ru/dictionary), а также сверяйтесь с глоссарием ниже +- При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком) +- Не переводите названия компаний, библиотек и т.д. +- Не переводите аббревиатуры (API, DOM, UI) +- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (URL'ы -> URL-адреса) +- Названия статей и заголовки пишите с одной заглавной буквы + +## Глоссарий + +**Пожалуйста, поддерживайте глоссарий в алфавитном порядке.** + +| Оригинальный термин | Перевод | +| ------------------ | ---------- | +| cache | кеш | +| feature | возможность (*менее предпочтительный синоним: функциональность*) | +| production | продакшен | +| render(ing) | рендер, рендерить, отрендерить | |