Merge remote-tracking branch 'upstream/master' into hoc-translation

* upstream/master: (103 commits)
  Fixes
  Fix title in refs-must-have-owner.md
  Убрал остатки испанского из очень плохого примера
  fix broken audio link in community roundup 26
  updated footer to get year based on current date
  README.md: fix link
  Fixes after review
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Update content/docs/hooks-intro.md
  Терминология: codemod
  Update content/docs/hooks-intro.md
  Translate MarkdownPage component
  Терминология: хук
  Терминология: TLDR
  Update hooks-intro.md
  ...

Author: agoldis

README.md

@@ -57,9 +57,9 @@ The documentation is divided into several sections with a different tone and pur
 
 ## Translation
 
-If you are interesting in translating `ru.reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/).
+If you are interested in translating `ru.reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/).
 
-If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg).
+If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#reactjsorg-translation).
 
 ## Troubleshooting
 

TRANSLATION.md

@@ -4,6 +4,18 @@
 
 Пожалуйста, используйте этот ишью, если вы хотите что-то перевести и узнать.
 
+## Оглавление
+
+* [Перевод на русский язык сайта reactjs.org](#Перевод-на-русский-язык-сайта-reactjsorg)
+  * [Оглавление](#Оглавление)
+  * [Общие правила](#Общие-правила)
+    * [Слово живое и мёртвое](#Слово-живое-и-мёртвое)
+  * [Универсальное руководство по стилю](#Универсальное-руководство-по-стилю)
+    * [Идентификаторы заголовков](#Идентификаторы-заголовков)
+    * [Текст в блоках кода](#Текст-в-блоках-кода)
+    * [Внешние ссылки](#Внешние-ссылки)
+  * [Соглашение по переводу (глоссарий)](#Соглашение-по-переводу-глоссарий)
+
 ## Общие правила
 
 - _Вы_ и его производные пишите с маленькой буквы
@@ -13,10 +25,12 @@
 - Используйте терминологию [словаря «Веб-стандартов»](https://github.com/web-standards-ru/dictionary), если нет исходного варианта в таблице ниже
 - Ссылки на ресурсы (MDN, Wikipedia) должны вести на русскую версию, если есть соответствующий перевод.
 - Иностранные имена переводите с указанием оригинального имени в скобках: _Дэн Абрамов (Dan Abramov)_. При этом обязательно проверьте уже существующий перевод имени в [словаре имён «Веб-стандартов»](https://github.com/web-standards-ru/dictionary/blob/master/names.md)
+- Не переводите наименования компаний (Facebook, Airbnb), библиотек (Jest, Enzyme) и т.д.
+- Не переводите аббревиатуры (API, DOM, HOC, UI).
 - Исключайте отсылки на пол читателя (см. секцию 3 на [этой странице](http://www.un.org/ru/gender-inclusive-language/guidelines.shtml))
 - Названия статей и заголовки пишутся с одной заглавной буквы («Компоненты и пропсы», не «Компоненты и Пропсы»).
 
-## Слово живое и мёртвое
+### Слово живое и мёртвое
 
 Прежде чем переводить, почитайте пару страниц из «Слова живого и мёртвого» Норы Галь. Хотя бы эти две:
 
@@ -48,7 +62,107 @@
 
 Небольшие вольности в переводе допускаются, но только если они помогают передать смысл. Перевод не должен быть ни деревянным, ни фамильярным. Истина где-то посередине.
 
-## Соглашение по переводу
+## Универсальное руководство по стилю
+
+Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/master/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация.
+
+### Идентификаторы заголовков
+
+Каждый заголовок имеет явный идентификатор:
+
+```md
+## Try React {#try-react}
+```
+
+**НЕ** переводите такие идентификаторы! Они используются для навигации. Изменение идентификатора неизбежно приведёт к поломке, если на документ ссылкаются извне, например так:
+
+```md
+Прочтите [главу для начинающих](/getting-started#try-react), чтобы узнать больше.
+```
+
+✅ Можно:
+
+```md
+## Попробуйте React {#try-react}
+```
+
+❌ НЕЛЬЗЯ:
+
+```md
+## Попробуйте React {#попробуйте-react}
+```
+
+Это сломает ссылку, приведённую в примере выше.
+
+### Текст в блоках кода
+
+Не переводите текст в блоках кода, кроме комментариев. А вот комментарии и текст в строках следует переводить, если они не относятся к коду.
+
+Пример:
+```js
+// Example
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+✅ МОЖНО:
+
+```js
+// Пример
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+✅ ТОЖЕ МОЖНО:
+
+```js
+// Пример
+const element = <h1>Здравствуй, мир!</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+❌ НЕЛЬЗЯ:
+
+```js
+// Пример
+const element = <h1>Здравствуй, мир!</h1>;
+// "root" ссылается на идентификатор элемента.
+// Не переводите его!
+ReactDOM.render(element, document.getElementById('корень'));
+```
+
+❌ СОВСЕМ НЕЛЬЗЯ:
+
+```js
+// Пример
+пост элемент = <з1>Здравствуй, мир!</з1>;
+РеактДОМ.отрендери(элемент, документ.получиЭлементПоАйди('корень'));
+```
+
+### Внешние ссылки
+
+Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia], и там существует статья на русском языке, исправьте ссылку, чтобы она указывала на русский вариант, даже если он неполный или требует улучшения.
+
+[MDN]: https://developer.mozilla.org/en-US/
+[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page
+
+Пример:
+
+```md
+React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).
+```
+
+✅ OK:
+
+```md
+Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82).
+```
+
+Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть.
+
+## Соглашение по переводу (глоссарий)
+
+**Пожалуйста, поддерживайте глоссарий в алфавитном порядке.**
 
 | Оригинальный термин | Перевод |
 | ------------------ | ---------- |
@@ -58,6 +172,7 @@
 | attribute | атрибут |
 | batch | группа обновлений |
 | batching | группировка |
+| bind | привязка |
 | bug | баг, дефект |
 | bundler | бандлер |
 | callback | колбэк |
@@ -67,11 +182,14 @@
 | class component | классовый компонент |
 | cleanup | сброс (*напр., сбрасываемый эффект, сбросить эффект, сбрасывающая функция*) |
 | code splitting | разделение кода |
+| codemod | codemod-скрипт |
 | commit | фиксация |
 | context | контекст |
 | (un)controlled component | (не)контролируемый компонент |
-| custom hooks | пользовательские хуки |
+| cross-cutting concerns | cквозная функциональность |
+| custom | пользовательский (*напр., пользовательские хуки*) |
 | debugging | отладка |
+| destructuring | деструктуризация |
 | development | разработка |
 | development mode | режим разработки |
 | developer tools | инструменты разработки |
@@ -80,14 +198,15 @@
 | effect | эффект |
 | error | ошибка |
 | error boundary | предохранитель |
-| escape hatch | лазейка (*напр., императивные лазейки*)
+| escape hatch | лазейка (*напр., императивные лазейки*) |
 | fallback | запасной |
 | feature | возможность |
+| folder | папка |
 | framework | фреймворк |
 | function component | функциональный компонент |
 | helper | вспомогательный(ая); *напр., helper function — вспомогательная функция* |
 | Higher-Order Component(s) | Компонент(ы) высшего порядка |
-| hook | хук *(с маленькой буквы)* |
+| hook | хук *(с маленькой буквы)* *(напр., хук эффекта, хук контекста)* |
 | incapsulation | инкапсуляция |
 | incapsulated | инкапсулированный |
 | key | ключ |
@@ -98,42 +217,48 @@
 | lifting state up | подъём состояния, поднимать состояние |
 | local state | внутреннее состояние |
 | lowercase | нижний регистр |
+| mixin | примесь |
 | mock | фиктивный |
 | (im)mutable | (им)мутабельный |
 | (im)mutability | (им)мутабельность |
 | (un)mount | (раз)монтирование |
 | mutate | мутировать |
+| native | нативный |
 | Note | Примечание |
 | online | онлайн |
 | online playground | онлайн-песочница |
 | paint | отрисовка, перерисовка |
+| persistent | персистентность, персистентный |
 | phase | этап (*напр., этап рендеринга, этап фиксации*) |
 | prop | проп *(ед. ч.)* |
 | props | пропсы *(мн. ч.)* |
 | production | продакшен |
 | production mode | продакшен-режим |
-| reducer | редюсер |
-| reuse | повторное использование, переиспользование |
 | React | React |
 | React element | React-элемент, элемент React |
 | reconciliation | согласование |
+| reducer | редюсер |
+| ref | реф *(ед. ч.)* |
+| refs | рефы *(мн. ч.)* |
+| ref forwarding | перенаправление рефа |
 | render(ing) | рендер, рендерить, отрендерить |
 | renderer | рендерер (*напр., поверхностный рендерер*) |
 | re-render(ing) | (по контексту) рендер, повторный рендер, последующий рендер, отрендерить снова |
 | render prop | рендер-проп *(ед. ч.)* |
 | render props | рендер-пропсы *(мн. ч.)* |
-| ref | реф *(ед. ч.)* |
-| refs | рефы *(мн. ч.)* |
+| reuse | повторное использование, переиспользование |
 | (previous/next) section | (предыдущая/следующая) глава *(только в разделе Основные понятия)* |
 | shallow | поверхностное (сравнение, равенство), поверхностный (рендеринг) |
 | side effect | побочный эффект |
+| snapshot | снимок |
 | state | состояние |
 | stateful component | компонент с состоянием |
 | stateless component | компонент без состояния |
 | suspense | задержка |
 | tag | тег |
 | template literals | шаблонные строки |
 | Tip | Совет |
+| TLDR | Вкратце |
 | Try it on CodePen | Посмотреть на CodePen |
 | tutorial | введение |
 | unidirectional data flow | однонаправленный поток данных |

content/blog/2015-03-30-community-roundup-26.md

@@ -29,7 +29,7 @@ Colin also [blogged about his experience using React Native](http://blog.scottlo
 
 Spencer Ahrens and I had the great pleasure to talk about React Native on [The Changelog](https://thechangelog.com/149/) podcast. It was really fun to chat for an hour, I hope that you'll enjoy listening to it. :)
 
-<audio src="http://fdlyr.co/d/changelog/cdn.5by5.tv/audio/broadcasts/changelog/2015/changelog-149.mp3" controls="controls" style="width: 100%"></audio>
+<audio src="https://cdn.changelog.com/uploads/podcast/149/the-changelog-149.mp3" controls="controls" style="width: 100%"></audio>
 
 
 ## Hacker News {#hacker-news}

content/docs/codebase-overview.md

@@ -211,7 +211,7 @@ Its main goals are:
 * Ability to return multiple elements from `render()`.
 * Better support for error boundaries.
 
-You can read more about React Fiber Architecture [here](https://github.com/acdlite/react-fiber-architecture) and [here](https://blog.ag-grid.com/index.php/2018/11/29/inside-fiber-in-depth-overview-of-the-new-reconciliation-algorithm-in-react). While it has shipped with React 16, the async features are not enabled by default yet.
+You can read more about React Fiber Architecture [here](https://github.com/acdlite/react-fiber-architecture) and [here](https://medium.com/react-in-depth/inside-fiber-in-depth-overview-of-the-new-reconciliation-algorithm-in-react-e1c04700ef6e). While it has shipped with React 16, the async features are not enabled by default yet.
 
 Its source code is located in [`packages/react-reconciler`](https://github.com/facebook/react/tree/master/packages/react-reconciler).