Merge pull request #150 from javaevolved/copilot/add-translation-to-russian

Add Russian (ru) translation

Author: brunoborges

html-generators/locales.properties

@@ -11,4 +11,5 @@ ko=🇰🇷 한국어
 bn=🇧🇩 বাংলা
 it=🇮🇹 Italiano
 pl=🇵🇱 Polski
-tr=🇹🇷 Türkçe
+tr=🇹🇷 Türkçe
+ru=🇷🇺 Русский

translations/content/ru/collections/collectors-teeing.yaml

@@ -0,0 +1,19 @@
+title: "Collectors.teeing()"
+oldApproach: Два прохода
+modernApproach: "teeing()"
+summary: Вычисление двух агрегаций за один проход по потоку.
+explanation: "Collectors.teeing() направляет каждый элемент в два дочерних Collector\
+  \ и объединяет результаты. Это позволяет избежать двукратного обхода данных или\
+  \ использования изменяемого аккумулятора."
+whyModernWins:
+- icon: "⚡"
+  title: Один проход
+  desc: Обработать поток один раз вместо двух.
+- icon: "🧩"
+  title: Комбинируемый
+  desc: Соединить два произвольных Collector с функцией слияния.
+- icon: "🔒"
+  title: Неизменяемый результат
+  desc: Сразу объединить в Record или Value-Object.
+support:
+  description: Широко доступно начиная с JDK 12 (март 2019)

translations/content/ru/collections/copying-collections-immutably.yaml

@@ -0,0 +1,19 @@
+title: Неизменяемое копирование коллекций
+oldApproach: Ручное копирование + обёртка
+modernApproach: "List.copyOf()"
+summary: Создание неизменяемой копии любой коллекции одним вызовом.
+explanation: "List.copyOf(), Set.copyOf() и Map.copyOf() создают неизменяемые снимки\
+  \ существующих коллекций. Если источник уже является неизменяемой коллекцией,\
+  \ копия не создаётся."
+whyModernWins:
+- icon: "⚡"
+  title: Умное копирование
+  desc: Копирование пропускается, если источник уже неизменяем.
+- icon: "📏"
+  title: Один вызов
+  desc: Без ручного создания ArrayList и обёртывания.
+- icon: "🛡️"
+  title: Любая коллекция
+  desc: Принимает любую Collection на входе — без промежуточного преобразования в ArrayList.
+support:
+  description: Широко доступно начиная с JDK 10 (март 2018)

translations/content/ru/collections/immutable-list-creation.yaml

@@ -0,0 +1,19 @@
+title: Создание неизменяемых списков
+oldApproach: Многословное обёртывание
+modernApproach: "List.of()"
+summary: Создание неизменяемых списков одним чистым выражением.
+explanation: "List.of() создаёт по-настоящему неизменяемый список — без обёртывания\
+  \ и защитного копирования. Не допускает null-элементов и структурно неизменяем.\
+  \ Старый подход требовал трёх вложенных вызовов."
+whyModernWins:
+- icon: "📏"
+  title: Один вызов
+  desc: Заменить три вложенных вызова одним фабричным методом.
+- icon: "🔒"
+  title: По-настоящему неизменяемый
+  desc: Не просто обёртка — сам список неизменяем.
+- icon: "🛡️"
+  title: Безопасен для null
+  desc: Отклоняет null-элементы при создании и немедленно завершается с ошибкой.
+support:
+  description: Широко доступно начиная с JDK 9 (сент. 2017)

translations/content/ru/collections/immutable-map-creation.yaml

@@ -0,0 +1,18 @@
+title: Создание неизменяемых Map
+oldApproach: Паттерн Map-Builder
+modernApproach: "Map.of()"
+summary: Создание неизменяемых Map встроенно без Builder.
+explanation: "Map.of() принимает пары ключ-значение встроенно и возвращает неизменяемую\
+  \ Map. Для более чем 10 записей использовать Map.ofEntries() с парами Map.entry()."
+whyModernWins:
+- icon: "📏"
+  title: Встроенное создание
+  desc: Не требует временной изменяемой Map.
+- icon: "🔒"
+  title: Неизменяемый результат
+  desc: Map нельзя изменить после создания.
+- icon: "🚫"
+  title: Без null-ключей/значений
+  desc: Null-записи немедленно отклоняются.
+support:
+  description: Широко доступно начиная с JDK 9 (сент. 2017)

translations/content/ru/collections/immutable-set-creation.yaml

@@ -0,0 +1,18 @@
+title: Создание неизменяемых Set
+oldApproach: Многословное обёртывание
+modernApproach: "Set.of()"
+summary: Создание неизменяемых Set одним фабричным вызовом.
+explanation: "Set.of() создаёт по-настоящему неизменяемое Set, которое отклоняет\
+  \ null-элементы и дубликаты при создании. Больше никакого обёртывания изменяемых Set."
+whyModernWins:
+- icon: "📏"
+  title: Лаконично
+  desc: Одна строка вместо трёх вложенных вызовов.
+- icon: "🚫"
+  title: Обнаруживает дубликаты
+  desc: Выбрасывает исключение при случайной передаче повторяющихся элементов.
+- icon: "🔒"
+  title: Неизменяемый
+  desc: Нельзя добавлять или удалять элементы после создания.
+support:
+  description: Широко доступно начиная с JDK 9 (сент. 2017)

translations/content/ru/collections/map-entry-factory.yaml

@@ -0,0 +1,19 @@
+title: "Фабрика Map.entry()"
+oldApproach: SimpleEntry
+modernApproach: "Map.entry()"
+summary: Создание записей Map с помощью чистого фабричного метода.
+explanation: "Map.entry() заменяет многословный конструктор AbstractMap.SimpleEntry.\
+  \ Возвращает неизменяемую запись, идеально подходящую для Map.ofEntries()\
+  \ и операций со Stream."
+whyModernWins:
+- icon: "📏"
+  title: Лаконично
+  desc: Одна строка вместо трёх с более чётким намерением.
+- icon: "🔒"
+  title: Неизменяемый
+  desc: Возвращаемую запись нельзя изменить.
+- icon: "🧩"
+  title: Комбинируемый
+  desc: "Отлично работает с Map.ofEntries() для больших Map."
+support:
+  description: Широко доступно начиная с JDK 9 (сент. 2017)

translations/content/ru/collections/reverse-list-iteration.yaml

@@ -0,0 +1,20 @@
+title: Обратная итерация по списку
+oldApproach: Ручной ListIterator
+modernApproach: "reversed()"
+summary: Итерация по списку в обратном порядке с помощью чистого цикла for-each.
+explanation: "Метод reversed() из SequencedCollection возвращает представление списка\
+  \ в обратном порядке. Это представление опирается на исходный список, поэтому\
+  \ копирование не происходит. Расширенный цикл for делает обратную итерацию\
+  \ такой же читаемой, как прямую."
+whyModernWins:
+- icon: "📖"
+  title: Естественный синтаксис
+  desc: Расширенный цикл for вместо многословного ListIterator.
+- icon: "⚡"
+  title: Без копирования
+  desc: "reversed() возвращает представление — без накладных расходов на производительность."
+- icon: "🧩"
+  title: Согласованный API
+  desc: "Работает единообразно на List, Deque и SortedSet."
+support:
+  description: Широко доступно начиная с JDK 21 LTS (сент. 2023)

translations/content/ru/collections/sequenced-collections.yaml

@@ -0,0 +1,19 @@
+title: Упорядоченные коллекции
+oldApproach: Арифметика с индексами
+modernApproach: getFirst/getLast
+summary: "Доступ к первому/последнему элементу и получение обратных представлений с помощью чистых методов API."
+explanation: "SequencedCollection добавляет getFirst(), getLast(), reversed(), addFirst()\
+  \ и addLast() к List, Deque, SortedSet и LinkedHashSet. Больше никакой арифметики\
+  \ size-1 или ручной обратной итерации."
+whyModernWins:
+- icon: "📖"
+  title: Самодокументируемый
+  desc: "getLast() понятнее, чем get(size()-1)."
+- icon: "🔄"
+  title: Обратное представление
+  desc: "reversed() возвращает представление — копирование не требуется."
+- icon: "🧩"
+  title: Единый API
+  desc: "Работает одинаково на List, Deque и SortedSet."
+support:
+  description: Широко доступно начиная с JDK 21 LTS (сент. 2023)

translations/content/ru/collections/stream-toarray-typed.yaml

@@ -0,0 +1,19 @@
+title: Типизированный Stream-toArray
+oldApproach: Ручная фильтрация + копирование
+modernApproach: "toArray(generator)"
+summary: Преобразование Stream в типизированные массивы с помощью ссылки на метод.
+explanation: "Метод toArray(IntFunction) создаёт правильно типизированный массив\
+  \ из Stream. Генератор (String[]::new) сообщает Stream, какой тип массива\
+  \ нужно создать."
+whyModernWins:
+- icon: "🎯"
+  title: Типобезопасный
+  desc: "Без приведения к Object[] — тип массива правильный."
+- icon: "🔗"
+  title: Цепочечный
+  desc: Работает в конце любого потокового конвейера.
+- icon: "📏"
+  title: Лаконично
+  desc: Одно выражение заменяет ручной цикл.
+support:
+  description: Широко доступно начиная с JDK 8 (март 2014)