Merge branch 'ru-translate' into develop

# Conflicts:
#	src/content/docs/version-3.0/mail-checkout.mdx
#	src/content/docs/version-3.0/mail-get-started.mdx

Author: eandreeva-twr

.claude/skills/editor/SKILL.md

@@ -241,6 +241,9 @@ After completing all checks, follow this flow:
 - Validate ALL links and images
 - Check intro, heading hierarchy, parallel headings, long blocks
 
+### Localization
+Files in `src/locales/` are automatically translated and updated by a GitHub Actions workflow on push to `main`. Do not edit them as part of normal doc work — edit only the source English file in `src/content/docs/`. The exception is targeted manual corrections explicitly requested (e.g., a native speaker flagging a translation error).
+
 ### Writing a Full Article
 - Complete all 5 phases — no shortcuts
 - Match tone and depth of neighboring articles

.env

@@ -6,4 +6,5 @@ PUBLIC_ALGOLIA_ANALYTICS_KEY=5e3fd9357b98f9f0d44bab0f0b7634c0
 
 # Locale-specific Algolia indices
 PUBLIC_ALGOLIA_INDEX_NAME_ZH=adapty_zh
-PUBLIC_ALGOLIA_INDEX_NAME_TR=adapty_tr
+PUBLIC_ALGOLIA_INDEX_NAME_TR=adapty_tr
+PUBLIC_ALGOLIA_INDEX_NAME_RU=adapty_ru

.github/workflows/s3-deploy-development.yml

@@ -44,7 +44,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr]
+        locale: [zh, tr, ru]
     steps:
       - uses: actions/checkout@v4
 
@@ -103,6 +103,11 @@ jobs:
           name: build-tr
           path: build/tr/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-ru
+          path: build/ru/
+
       - name: Deploy
         uses: reggionick/s3-deploy@v4
         with:

.github/workflows/s3-deploy-production.yml

@@ -96,7 +96,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr]
+        locale: [zh, tr, ru]
     steps:
       - uses: actions/checkout@v4
 
@@ -155,6 +155,11 @@ jobs:
           name: build-tr
           path: build/tr/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-ru
+          path: build/ru/
+
       - name: Deploy
         uses: reggionick/s3-deploy@v4
         with:
@@ -180,7 +185,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        locale: [zh, tr]
+        locale: [zh, tr, ru]
     steps:
       - uses: actions/checkout@v4
 
@@ -234,18 +239,24 @@ jobs:
           name: build-tr-only-tr
           path: build/tr/
 
+      - uses: actions/download-artifact@v4
+        with:
+          name: build-tr-only-ru
+          path: build/ru/
+
       # Sync locale directories to S3 using AWS CLI —
-      # only overwrites zh/ and tr/ prefixes, leaves English untouched.
+      # only overwrites zh/, tr/, and ru/ prefixes, leaves English untouched.
       - name: Deploy translations to S3
         run: |
           aws s3 sync build/zh/ s3://${{ secrets.S3_BUCKET }}/zh/ --delete
           aws s3 sync build/tr/ s3://${{ secrets.S3_BUCKET }}/tr/ --delete
+          aws s3 sync build/ru/ s3://${{ secrets.S3_BUCKET }}/ru/ --delete
 
       - name: Invalidate locale paths
         run: |
           aws cloudfront create-invalidation \
             --distribution-id ${{ secrets.CLOUDFRONT_DISTRIBUTION_ID }} \
-            --paths "/zh/*" "/tr/*"
+            --paths "/zh/*" "/tr/*" "/ru/*"
 
       - name: Update deployment tag
         run: |

.gitignore

@@ -35,6 +35,7 @@ yarn-error.log*
 .translate-batch-id
 src/locales/zh/.hashes/
 src/locales/tr/.hashes/
+src/locales/ru/.hashes
 
 # VSCode
 /.vscode/*

CLAUDE.md

@@ -44,6 +44,10 @@ Sidebars are defined per platform in `src/data/sidebars/*.json` (ios, android, r
 - Use `<ZoomImage id="image.png" width="700px" alt="desc" />` (preferred)
 - Legacy `<Zoom><img src={require(...)}/></Zoom>` still works
 
+### Localization
+
+Translated versions of articles live in `src/locales/{locale}/` (e.g., `src/locales/zh/`, `src/locales/tr/`). A GitHub Actions workflow automatically translates and updates them on every push to `main` — do not edit them as part of normal doc work. Edit only the source English file in `src/content/docs/`. The only exception is targeted manual corrections requested explicitly (e.g., fixing a translation error a native speaker caught).
+
 ### Path aliases
 
 - `@site` → repo root

astro.config.mjs

@@ -87,7 +87,7 @@ export default defineConfig({
     react(),
     sitemap({
       // Exclude localized pages — they are covered by locale-specific sitemaps (e.g. sitemap-zh-index.xml)
-      filter: (page) => !page.includes('/docs/zh/') && !page.includes('/docs/tr/'),
+      filter: (page) => !page.includes('/docs/zh/') && !page.includes('/docs/tr/') && !page.includes('/docs/ru/'),
       // Strip trailing slashes so sitemap URLs match the canonical tags emitted by DocsLayout.
       // The canonical strips trailing slashes (DocsLayout.astro:35-37), so the sitemap must too.
       // Mismatch causes the Algolia crawler (ignoreCanonicalTo: false) to skip sitemap entries.

package.json

@@ -12,6 +12,8 @@
     "translate:zh:build": "node scripts/translate.mjs --lang zh --incremental",
     "translate:tr": "node scripts/translate.mjs --lang tr",
     "translate:tr:build": "node scripts/translate.mjs --lang tr --incremental",
+    "translate:ru": "node scripts/translate.mjs --lang ru",
+    "translate:ru:build": "node scripts/translate.mjs --lang ru --incremental",
     "preview": "astro preview",
     "astro": "astro",
     "check-links": "node scripts/check-links/index.mjs",