Merge pull request #395 from bitrise-io/update-translation-workflow

Change translation workflow trigger to manual

Author: zoltan-baba

.github/workflows/translate-ja-docs.yml

@@ -1,6 +1,9 @@
 # =====================================================================
 # Translate changed English docs to Japanese on PRs
 # =====================================================================
+
+# !!!THIS WORKFLOW IS NOT USED. DO NOT READ ANY FURTHER: THE WORKFLOW IS KEPT FOR POSSIBLE FUTURE USE ONLY.!!!
+
 # When a PR changes English docs, translate ONLY the changed files to Japanese
 # and commit the JA versions back to the PR branch. This keeps JA in
 # lock-step with EN — it can never silently go stale. Added/modified pages
@@ -37,13 +40,14 @@
 name: Translate docs to Japanese
 
 on:
-  pull_request:
-    types: [opened, synchronize]
-    paths:
-      - 'docs/**/*.md'          # <-- adjust to your English docs location
-      - 'docs/**/*.mdx'
-      - 'src/partials/**/*.mdx' # reusable partials are translated too
-      - 'docs/**/_category_.json' # sidebar labels feed translate_ui_strings.py
+  workflow_dispatch: 
+  # pull_request:
+  #  types: [opened, synchronize]
+  #  paths:
+  #    - 'docs/**/*.md'          # <-- adjust to your English docs location
+  #    - 'docs/**/*.mdx'
+  #    - 'src/partials/**/*.mdx' # reusable partials are translated too
+  #    - 'docs/**/_category_.json' # sidebar labels feed translate_ui_strings.py
 
 # A fast-follow push to the same PR (a very ordinary thing to do — push,
 # notice something, push again) starts a new run while the previous one may
@@ -64,6 +68,7 @@ permissions:
 
 jobs:
   check-key:
+    if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
     outputs:
       enabled: ${{ steps.key.outputs.enabled }}

CLAUDE.md

@@ -341,7 +341,7 @@ Anything reused across pages: a setup-prerequisites paragraph, a "how to open th
 
 ### Japanese translations of partials
 
-Every partial is also translated: `src/partials/<slug>.mdx` → `i18n/ja/partials/<slug>.mdx`, by `translate_docs.py` (the workflow watches `src/partials/` too). Translated pages import the Japanese copy (`@site/i18n/ja/partials/<slug>.mdx`) instead of the English one; list-context references are filled from the Japanese copy by `docusaurus.config.ts` for pages under `i18n/ja/`. Edit only the English partial — never the `i18n/ja/partials/` copy.
+Every partial is also translated: `src/partials/<slug>.mdx` → `i18n/ja/partials/<slug>.mdx`, by `translate_docs.py`, or by `scripts/ja_manual_translate.py` when no API key is available (`scripts/detect_ja_drift.py` lists the missing and stale partials and pages). Translated pages import the Japanese copy (`@site/i18n/ja/partials/<slug>.mdx`) instead of the English one; list-context references are filled from the Japanese copy by `docusaurus.config.ts` for pages under `i18n/ja/`. Edit only the English partial — never the `i18n/ja/partials/` copy.
 
 ### Japanese UI strings and frontmatter
 

localization/README.md

@@ -22,7 +22,7 @@ A self-updating system that (1) keeps a **UI copy library** in sync with the liv
 | `ja-preferred-translations.yaml` | Human-owned terminology-consistency map — one approved Japanese rendering per English term we *do* translate (e.g. "build number" → "ビルド番号"). Separate from the glossary because the glossary is regenerated weekly and would overwrite it. |
 | `JA-TRANSLATION-GUIDE.md` | House rules for the translation (register, orthography, terminology) with a LIVE/PROCESS/ROADMAP status legend. |
 | `.github/workflows/refresh-ui-library.yml` | Weekly + on-demand: rebuilds the library/glossary and opens a PR if anything changed — touching only `localization/`, a diff a human can actually review. |
-| `.github/workflows/translate-ja-docs.yml` | On docs PRs: translates the changed pages and commits the JA versions. **Ships disabled** — gated on the existence of the `ANTHROPIC_API_KEY` secret; until it's added, the job skips silently on every PR. |
+| `.github/workflows/translate-ja-docs.yml` | Translate-on-PR workflow. **Not used**: its `pull_request` trigger is commented out, so it never runs or appears as a check on PRs. To bring Japanese pages up to date, `scripts/detect_ja_drift.py` lists the missing and stale pages and `scripts/ja_manual_translate.py` translates them without an API key. |
 | `.github/workflows/ja-style-check.yml` + `.textlintrc.yaml` | Runs the JTF Japanese Standard Style Guide checker (textlint) on changed JA docs — the automated stand-in for a native reviewer on style/orthography, not meaning. |
 
 ## How it flows
@@ -66,7 +66,7 @@ A self-updating system that (1) keeps a **UI copy library** in sync with the liv
 2. Add `NT` to the `ALLOWED` set in `docusaurus.config.ts`'s markdown preprocessor — it escapes any JSX tag name not on that list, so without this a manual `<NT>` renders as literal escaped text instead of the component.
 3. Add the `CI_REPO_TOKEN` repo secret — a PAT or GitHub App token with **read** access to `bitrise-website`, `bitrise-workflow-editor`, `bitrise-codespaces`, `bitkit`, `bitrise-steplib` (the default `GITHUB_TOKEN` can't read other repos).
 4. Enable Actions. Run **Refresh UI copy library** once manually to seed `localization/`. No tagging pass is needed — the docs source stays as-is; protection is applied at translation time.
-5. When enough pages are migrated to keep `/ja/` in lock-step, add the `ANTHROPIC_API_KEY` repo secret — its existence is the ON switch for translate-on-PR. Until then the job skips silently on every docs PR.
+5. Translate-on-PR is switched off on purpose. To bring it back, restore the `pull_request` trigger in `translate-ja-docs.yml` and add the `ANTHROPIC_API_KEY` repo secret.
 
 ## Run locally (no CI)