Finish translation of the project into Russian language

.dockerignore

@@ -1,17 +1,17 @@
-# Keep the build context small and deterministic.
-# NOTE: do NOT exclude *.md — the book sources are markdown.
+# Держим контекст сборки небольшим и детерминированным.
+# ПРИМЕЧАНИЕ: НЕ исключайте *.md — исходники книг написаны в Markdown.
 
 .git
 .github
 .gitignore
 
-# Build output (mirrors .gitignore)
+# Результаты сборки (повторяют .gitignore)
 target/
 site/
 docs/
 **/book/
 
-# Editor / OS noise
+# Файлы редакторов и ОС
 .vscode/
 .idea/
 **/*:Zone.Identifier

.github/workflows/docker.yml

@@ -1,7 +1,8 @@
-name: Docker image
+name: Образ Docker
 
-# Build-only. Nothing is published, so this adds no release surface or
-# registry credentials — it exists so the Dockerfile cannot silently rot.
+# Только сборка. Ничего не публикуется, поэтому нет дополнительной поверхности
+# релизов и учётных данных реестра. Workflow нужен, чтобы Dockerfile не
+# сломался незаметно.
 on:
   push:
     branches: [main]
@@ -31,7 +32,7 @@ jobs:
 
       - uses: docker/setup-buildx-action@37fe631027851001ddb9b187196cc803df7f5f0e # v4.3.0
 
-      - name: Build image
+      - name: Сборка образа
         uses: docker/build-push-action@53b7df96c91f9c12dcc8a07bcb9ccacbed38856a # v7.3.0
         with:
           context: .
@@ -42,20 +43,20 @@ jobs:
           cache-from: type=gha
           cache-to: type=gha,mode=max
 
-      - name: Smoke test
+      - name: Дымовой тест
         run: |
           docker run -d --name books -p 3000:8080 rust-training:ci
           for i in $(seq 1 30); do
             if curl -fsS http://localhost:3000/ >/dev/null 2>&1; then ok=1; break; fi
             sleep 2
           done
           if [ "${ok:-0}" != "1" ]; then
-            echo "::error::server did not come up"; docker logs books; exit 1
+            echo "::error::сервер не поднялся"; docker logs books; exit 1
           fi
-          # Landing page and at least one book must resolve.
-          # NB: match the <title>; the <h1> is split by a <span> tag.
-          curl -fsS http://localhost:3000/ | grep -q "<title>Rust Training Books</title>"
+          # Обложка и хотя бы одна книга должны открываться.
+          # ПРИМЕЧАНИЕ: сравниваем по <title>, потому что <h1> разбит тегом <span>.
+          curl -fsS http://localhost:3000/ | grep -q "<title>Учебные книги по Rust</title>"
           curl -fsS -o /dev/null -w '%{http_code}\n' http://localhost:3000/async-book/ | grep -q 200
-          # Extensionless links must resolve via try_files.
+          # Ссылки без расширения должны открываться через try_files.
           curl -fsS -o /dev/null -w '%{http_code}\n' http://localhost:3000/async-book/ch00-introduction | grep -q 200
           docker rm -f books

.github/workflows/pages.yml

@@ -1,4 +1,4 @@
-name: Deploy to GitHub Pages
+name: Публикация на GitHub Pages
 
 on:
   push:
@@ -18,16 +18,16 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
+      - name: Получение кода
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - name: Install Rust
+      - name: Установка Rust
         uses: dtolnay/rust-toolchain@stable
 
-      - name: Configure GitHub Pages
+      - name: Настройка GitHub Pages
         uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
 
-      - name: Cache cargo dependencies
+      - name: Кэш зависимостей cargo
         uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
         with:
           path: |
@@ -40,15 +40,15 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-cargo-
 
-      - name: Install mdbook and dependencies
+      - name: Установка mdbook и зависимостей
         run: |
           which mdbook || cargo install mdbook
           which mdbook-mermaid || cargo install mdbook-mermaid
 
-      - name: Build documentation
+      - name: Сборка документации
         run: cargo xtask deploy
 
-      - name: Upload artifact
+      - name: Загрузка артефакта
         uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
         with:
           path: ./docs
@@ -60,6 +60,6 @@ jobs:
     runs-on: ubuntu-latest
     needs: build
     steps:
-      - name: Deploy to GitHub Pages
+      - name: Публикация на GitHub Pages
         id: deployment
         uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1

.gitignore

@@ -1,10 +1,10 @@
-# mdbook build output
+# Результат сборки mdbook
 **/book/
 
-# xtask output
+# Результат xtask
 site/
 docs/
 target/
 
-# Zone.Identifier files (Windows/WSL artifact)
+# Файлы Zone.Identifier (артефакт Windows/WSL)
 *:Zone.Identifier

CODE_OF_CONDUCT.md

@@ -1,11 +1,25 @@
-# Microsoft Open Source Code of Conduct
+# Кодекс поведения участников
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+Мы хотим, чтобы участие в проекте было открытым и безопасным для всех, независимо от опыта, возраста, пола, национальности, религии, инвалидности и других личных признаков.
 
-Resources:
+## Чего мы ждём
 
-- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
-- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
-- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
-- Employees can reach out at [aka.ms/opensource/moderation-support](https://aka.ms/opensource/moderation-support)
+- Уважительного общения и готовности выслушать других.
+- Конструктивной критики, которая направлена на текст и код, а не на человека.
+- Внимания к технической сути: проверяйте факты и ссылки на документацию.
+- Признания чужого вклада, в том числе в переводе и в ревью.
 
+## Что недопустимо
+
+- Оскорбления, унижения, преследование и травля.
+- Публикация чужих личных данных без согласия.
+- Сознательное введение в заблуждение, спам и реклама, не связанные с проектом.
+- Любое поведение, которое создаёт враждебную обстановку для участников.
+
+## Ответственность
+
+Мейнтейнеры проекта могут удалить комментарии, коммиты и Pull Request'ы, которые нарушают этот кодекс, и ограничить доступ к обсуждениям участникам, которые систематически его нарушают.
+
+## Как сообщить о проблеме
+
+Вопросы о кодексе задавайте через Issues репозитория. Если обращение конфиденциально, напишите мейнтейнеру напрямую через его профиль на GitHub: [@r007](https://github.com/r007).

CONTRIBUTING.md

@@ -1,14 +1,47 @@
-# Contributing
+# Как внести вклад
 
-This project welcomes contributions and suggestions. Most contributions require you to
-agree to a Contributor License Agreement (CLA) declaring that you have the right to,
-and actually do, grant us the rights to use your contribution. For details, visit
-https://cla.microsoft.com.
+Спасибо, что хотите помочь проекту! Здесь принимаются исправления текста и перевода, правки примеров кода, улучшения сборки и предложения новых тем.
 
-When you submit a pull request, a CLA-bot will automatically determine whether you need
-to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the
-instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
+Подписывать соглашение о вкладе (CLA) не нужно. Отправляя изменения, вы соглашаетесь, что они распространяются по лицензиям проекта: MIT для кода и CC BY 4.0 для текста.
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
-or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+## Что можно предложить
+
+- Исправления опечаток, неточностей и ошибок в переводе.
+- Улучшения примеров кода и упражнений. Код должен компилироваться.
+- Исправления ссылок, якорей и сборки.
+- Новые главы или книги. Сначала откройте Issue, чтобы обсудить объём и структуру.
+
+## Как работать
+
+1. Сделайте fork репозитория и создайте ветку от `main`.
+2. Внесите изменения и проверьте сборку: `cargo xtask build` или `cd <книга> && mdbook build`.
+3. Откройте Pull Request с кратким описанием того, что изменено и почему.
+
+## Стиль перевода
+
+- Обращение к читателю на «вы».
+- Термины используем единообразно (см. таблицу ниже).
+- Код, идентификаторы, имена файлов, команды и сообщения компилятора остаются на английском.
+- Комментарии в примерах кода пишем по-русски.
+- Имена файлов и якорные ссылки без необходимости не меняем: от них зависят ссылки внутри книг и связь с оригиналом.
+
+## Глоссарий
+
+| English | Русский | Примечание |
+|---------|---------|------------|
+| trait | трейт | |
+| crate | крейт | |
+| ownership | владение | |
+| borrowing | заимствование | |
+| lifetime | время жизни | |
+| closure | замыкание | |
+| iterator | итератор | |
+| panic | паника | |
+| thread | поток | |
+| channel | канал | |
+| runtime | рантайм | |
+| Future, Pin, Mutex, Send, Sync, PhantomData, newtype, typestate, UB | — | оставляем английскими |
+
+## Кодекс поведения
+
+Участие в проекте регулируется [кодексом поведения](CODE_OF_CONDUCT.md).