Repository navigation
Repair structural defects in the JA docs (part of TW-1786) - #335
Merged
Merged
Conversation
…pans The app UI is English-only, but 227 bold spans across 102 JA pages mixed English with Japanese (e.g. "Save NPMキャッシュ", "UIテスト用のAndroid Build"). Each is replaced with the exact English span from the same line of the English source, and all 227 occur verbatim there. The 82 "…のExample" bold labels are left alone: fixing them needs new Japanese. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T641RxhBBd3yTdKhMyorpq
33 links lost their opening `[` (23 of them as `[text]](url)`), one had a stray `)]` and one had its URL inlined into the text. Only brackets and parentheses move: the Japanese text is byte-identical, and every repaired page's link targets now equal its English source. ja_structure.py reports 0 structural differences across all 498 page pairs afterwards. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T641RxhBBd3yTdKhMyorpq
The translator glued adjacent English words ("iOScode signing",
"OktaSSO", "AndroidSDK", "BitrisePipelineの設定"). 324 single spaces
are inserted, nothing else changes, and each restored "word word" pair
occurs with that space in the page's English source.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T641RxhBBd3yTdKhMyorpq
initializing-a-bitrise-project-locally had 3 (English: 6) and running-your-first-local-build-with-the-cli had 5 (English: 8), so the JA sidebar ordered the CLI section differently. These are the only 2 non-translated frontmatter mismatches across 498 JA pages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T641RxhBBd3yTdKhMyorpq
The glossary already protects "Code Signing" (case-insensitive, so every "code signing"), yet ja-preferred-translations.yaml also mapped it to コード署名: the file's own "never both" rule was broken, and JA mixed "code signing" with 10 コード署名 (8 in 7 pages, 2 UI labels). The preferred entry is removed, those 10 now read "code signing" as the surrounding JA already does, and "iOS code signing" joins keep_english. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T641RxhBBd3yTdKhMyorpq
ilanazholobovsky
requested review from
aorcsik,
matenadasdi and
zoltan-baba
as code owners
October 7, 2026 12:13
This was referenced Oct 7, 2026
Collaborator
Author
|
Checked on the live previews. Same page (About integrations, "Public projects" note), before and after: Before ( After ( Across the 14 link-fix pages: raw |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Base:
ja-translation-test(#325). Merge this first — the pipeline PR stacked on top adds a CI check that these repairs make pass.Summary
Fixes the visible defects a review of #325 found in the translated pages: broken links, UI labels and Step names half-translated in bold, English words glued together, and two wrong sidebar positions. Every change restores something the English source already has, so it can be checked without reading Japanese. No new Japanese text is added and no English file changes.
Outcome
](/path)text where a link should be (14 pages).iOScode signing,OktaSSO) are separated again across 136 pages.Commits (each can be dropped on its own)
2d622fc6Restore 227 half-translated bold UI labels and Step names to their exact English (e.g.Newタスク→New task). Each matches an English bold span exactly.475174a0Repair link markup in 14 pages: 23 doubled]](, 11 missing[, 1 misplaced bracket, 1 lost link. Japanese text is byte-identical; only brackets move. Link targets now match English on every page.4466a37bRestore 324 lost spaces in 136 pages. Each restored phrase exists on the matching English page.5138099fMatchsidebar_positionto English on 2 Bitrise CLI pages (English changed after translation).99905d6fKeep "code signing" in English (team policy: when in doubt, keep English). Removes thecode signing → コード署名preferred translation, which contradicted the glossary entry protecting it, and replaces 10 occurrences.Verification
scripts/ja_structure.py(from the stacked pipeline PR): 0 structural problems across 498 pages, 30 before.heading_ids.py --check: 0 pages to update.pytest scripts/: 74 passed.docusaurus build --locale ja: exits 0, 0 broken links; the same 5 broken anchors as before, all also broken in English.docs/andsrc/partials/untouched.Still needs re-translation (after the pipeline PR merges)
These are the 89 pages that remain after the matcher fix, grouped by reason, each listed once. Paths are relative to
i18n/ja/docusaurus-plugin-content-docs/current/, exceptpartials/, which is underi18n/ja/.English UI phrase frozen mid-sentence, no longer protected (59)
bitrise-build-cache/build-cache-for-gradle/gradle-execution-reason-diagnostic-builds.mdx: "create a new workflow"bitrise-ci/api/github-app-configuration-api.mdx: "enable the"bitrise-ci/code-signing/ios-code-signing/managing-ios-code-signing-files-automatic-provisioning.mdx: "set up"bitrise-ci/configure-builds/configuration-yaml/storing-an-apps-configuration-yaml.mdx: "you have"bitrise-ci/configure-builds/configuring-build-settings/configuring-slack-integration.mdx: "set up"bitrise-ci/configure-builds/configuring-build-settings/configuring-tool-versions.mdx: "how to use community plugins"bitrise-ci/configure-builds/configuring-build-settings/selective-builds.mdx: "you have"bitrise-ci/configure-builds/secrets.mdx: "select a workflow"bitrise-ci/getting-started/adding-a-new-project.mdx: "set up"bitrise-ci/getting-started/quick-start-guides/getting-started-with-ios-projects.mdx: "you have"; also glued "ioStep"bitrise-ci/getting-started/quick-start-guides/getting-started-with-react-native-projects.mdx: "you have"; also glued "theAndroid", "theiOS"; also English admonition title(s): "Publishing to expo.io"bitrise-ci/references/configuration-yaml-reference.mdx: "example", "read more"; also 82 bold "…のExample" labelsbitrise-ci/run-and-analyze-builds/build-data-and-troubleshooting/reporting-build-problems-in-pr-comments.mdx: "enable the"bitrise-ci/run-and-analyze-builds/build-triggers/configuring-build-triggers.mdx: "select a workflow"bitrise-ci/run-and-analyze-builds/starting-builds/scheduling-builds.mdx: "set up", "you have"bitrise-ci/testing/device-testing-with-firebase/device-testing-for-android.mdx: "provide a"bitrise-ci/testing/testing-ios-apps/building-an-ios-app-for-testing.mdx: "you install all of the app's dependencies"bitrise-ci/testing/testing-ios-apps/running-unit-and-ui-tests-for-ios-apps.mdx: "you install all of the app's dependencies"bitrise-ci/workflows-and-pipelines/ai-configuration-assistant.mdx: "enable ai features", "enable the"bitrise-ci/workflows-and-pipelines/developing-your-own-bitrise-step/creating-your-own-bitrise-project-scanner.mdx: "for the"bitrise-ci/workflows-and-pipelines/steps/enabling-or-disabling-a-step-conditionally.mdx: "enable the"bitrise-ci/workflows-and-pipelines/steps/step-versions.mdx: "example"bitrise-ci/workflows-and-pipelines/workflows/managing-workflows.mdx: "select a workflow"bitrise-platform/accounts/editing-your-profile-settings.mdx: "log in"bitrise-platform/accounts/saml-sso-in-bitrise/configuring-saml-sso-on-bitrise.mdx: "log in"bitrise-platform/accounts/saml-sso-in-bitrise/logging-in-via-saml-sso.mdx: "enter your username", "enter your work email"bitrise-platform/accounts/two-factor-authentication.mdx: "log in"bitrise-platform/getting-started/key-concepts-of-the-bitrise-platform.mdx: "set up"bitrise-platform/infrastructure/bitrise-on-aws-cloud-controller/creating-and-configuring-a-controller.mdx: "log in"bitrise-platform/integrations/ai-code-reviewer.mdx: "enable ai features", "enable the"; also English admonition title(s): "Third-party API vendor"bitrise-platform/integrations/apple-services-connection/connecting-to-an-apple-service-with-apple-id.mdx: "log in"bitrise-platform/integrations/connecting-a-google-service-account-to-bitrise.mdx: "set up"bitrise-platform/integrations/oidc-authentication/oidc-for-aws.mdx: "log in"bitrise-platform/integrations/the-service-credential-user.mdx: "log in"bitrise-platform/projects/changing-the-owner-of-a-project.mdx: "log in"bitrise-platform/projects/creating-white-label-app-versions.mdx: "go back"bitrise-platform/repository-access/connecting-bitbucket-server-instances.mdx: "authorize bitrise", "log in"bitrise-platform/repository-access/connecting-self-hosted-gitlab-instances.mdx: "log in"bitrise-platform/repository-access/integrating-github-enterprise-with-bitrise.mdx: "go back"bitrise-platform/repository-access/repository-access-with-oauth.mdx: "log in"bitrise-platform/workspaces/changing-the-owners-of-a-workspace.mdx: "enter an email address"bitrise-platform/workspaces/collaboration-and-permissions-in-workspaces/roles-and-permissions-in-workspaces.mdx: "set up"; also 1 English table header row(s)bitrise-platform/workspaces/creating-workspaces.mdx: "log in"bitrise-platform/workspaces/workspace-billing-and-invoicing.mdx: "set up"bitrise-rde/configuration/github-integration.mdx: "enable the", "you have"insights/getting-started-with-insights.mdx: "log in"insights/git-insights.mdx: "log in"partials/getting-to-your-profile-settings.mdx: "log in"partials/installing-javascript-dependencies-for-react-native-ionic-cordova-and-expo.mdx: "log in"partials/opening-an-app-in-release-management.mdx: "log in"partials/opening-the-workspace-settings-page.mdx: "log in"partials/switching-from-oauth-connection-to-the-github-app.mdx: "install the bitrise github app"partials/using-the-previous-version-of-a-stack.mdx: "log in"; also English admonition title(s): "Finding out the previous version number"partials/xcode-stack-updates.mdx: "your feedback"release-management/build-distribution/distributing-builds-to-testers.mdx: "for the"release-management/codepush/configuring-your-app-for-codepush.mdx: "set up"; also English admonition title(s): "Deployment keys are not secrets"release-management/configuring-connected-apps/deleting-a-connected-app.mdx: "log in"release-management/getting-started-with-release-management/connecting-another-ci-service-to-release-management.mdx: "sign up"release-management/installable-artifacts.mdx: "set up"English words glued together by the model (3)
bitrise-ci/deploying/android-deployment/generate-and-deploy-multiple-flavor-apks-in-a-single-workflow.mdx: glued "StepAFTER"bitrise-ci/run-and-analyze-builds/build-data-and-troubleshooting/ai-build-fixer.mdx: glued "theAI"bitrise-platform/projects/projects-overview.mdx: glued "upRelease"Untranslated blocks (2)
bitrise-ci/api/identifying-workspaces-and-apps-with-their-slugs.mdx: both tab step lists (10 lines) left English; source-side cause: a stray backtick in the English line "select `General settings" makes inline_code mask everything up to the next backtick, so fix docs/ firstbitrise-platform/ai/bitrise-mcp/installing-the-bitrise-mcp-server/install-kiro.mdx: list item "Set up release management" left EnglishTable header rows left in English (15)
bitrise-build-hub/infrastructure/build-stacks/about-build-stacks.mdx: 2 English table header row(s)bitrise-ci/api/incoming-and-outgoing-webhooks.mdx: 1 English table header row(s)bitrise-ci/api/managing-android-keystore-files.mdx: 1 English table header row(s)bitrise-ci/dependencies-and-caching/key-based-caching/using-key-based-caching.mdx: 1 English table header row(s)bitrise-ci/deploying/bitrise-ota-app-deployment.mdx: 1 English table header row(s)bitrise-ci/deploying/deploying-apps-to-deploygate-from-bitrise.mdx: 2 English table header row(s)bitrise-ci/run-and-analyze-builds/build-data-and-troubleshooting/bitrise-for-jira-app.mdx: 1 English table header row(s)bitrise-ci/testing/test-sharding.mdx: 1 English table header row(s)bitrise-ci/testing/testing-android-apps/testing-your-app-with-browserstacks-app-automate.mdx: 3 English table header row(s)bitrise-platform/integrations/apple-services-connection/about-connecting-to-apple-services.mdx: 1 English table header row(s)bitrise-platform/workspaces/collaboration-and-permissions-in-workspaces/custom-roles/permissions-reference.mdx: 4 English table header row(s)bitrise-rde/devices/device-preview-links.mdx: 1 English table header row(s)bitrise-rde/devices/device-sessions.mdx: 2 English table header row(s)release-management/api/adding-and-connecting-an-app.mdx: 2 English table header row(s)release-management/codepush/codepush-cli/codepush-cli-reference.mdx: 11 English table header row(s)Admonition titles left in English (10)
bitrise-build-cache/build-cache-for-gradle/configuring-the-build-cache-for-gradle-in-local-builds.mdx: "Environment Variables take precedence"bitrise-build-cache/build-cache-for-react-native/configuring-the-build-cache-for-react-native-in-local-builds.mdx: "Open a new terminal afterwards"; "Explicit module build warnings"bitrise-build-cache/build-cache-for-xcode/configuring-the-build-cache-for-xcode-in-local-builds.mdx: "Terminal builds only"; "Open a new terminal afterwards"; "Explicit module build warnings"bitrise-build-cache/getting-started-with-the-build-cache/per-project-cache-scoping.mdx: "Reactivation applies the change"bitrise-ci/bitrise-cli/adding-a-new-project-from-a-cli.mdx: "Adding a project with the API"; "Creating the project only"bitrise-ci/configure-builds/configuration-yaml/modular-yaml-configuration.mdx: "Accessing other repositories"; "Switching back to bitrise.io"; also 1 English table header row(s)bitrise-ci/run-and-analyze-builds/build-statuses.mdx: "Aborted with success"bitrise-ci/workflows-and-pipelines/build-pipelines/configuring-a-bitrise-pipeline.mdx: "Pipelines with stages"; "Optional Workflows using run_if conditions"; "Using environment variable keys"; "Graph pipelines only"bitrise-platform/getting-started/signing-up-for-bitrise.mdx: "Onboarding with an AI agent"partials/deploying-to-google-play.mdx: "Uploading the service account JSON key file"