Skip to content

Fix Japanese docs: typos, cross-refs, missing links, terminology - #1

Merged
miyako merged 5 commits into
mainfrom
miyako-fictional-eureka
Jul 30, 2026
Merged

Fix Japanese docs: typos, cross-refs, missing links, terminology#1
miyako merged 5 commits into
mainfrom
miyako-fictional-eureka

Conversation

@miyako

@miyako miyako commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Audits and fixes quality issues in the Japanese (ja) localization of the commands-legacy (and related) docs, applied consistently across current/, version-21/, version-21-R3/, and version-21-R4/ (and, for the terminology commits, the full i18n/ja tree). Every fix was verified against the English source (docs/ or versioned_docs/version-21/) before being applied, to avoid "fixing" legitimate Japanese text or intentional constructs.

What changed

  • Typos, duplicate particles, and broken katakana spacing: corrected duplicate-particle errors (のの/にから/にで, including a repeated boilerplate typo across 9 Blob command pages) and ~48 katakana terms broken by legacy hard line-wrap conversion in version-21/ (e.g. ヘッ ダー -> ヘッダー). Legitimate two-word boundaries (e.g. モード デフォルト値, マイ ドキュメント) were left untouched.
  • Semaphore cross-reference fixes: on-host-database-event-database-method.md incorrectly linked to the Semaphore command where the English source refers to the On Exit / On Startup database methods; also restored two links that were missing entirely from the same table.
  • Missing content restoration: restored a dropped "Go Mobile with 4D" link, a missing DELAY PROCESS link, a missing On Web Connection reference, and a plain-text mention that should have linked to On Backup Startup.
  • Terminology standardization: unified ブラウザ -> ブラウザー and フォルダ -> フォルダー to match the already-dominant long-vowel-mark spelling (JIS Z 8301 convention), applied via negative-lookahead substitution to avoid doubling existing long-vowel marks.

Notes for reviewers

  • Changes are split into separate commits by category (typos/particles, cross-refs, missing content, browser terminology, folder terminology) so each can be reviewed or reverted independently.
  • <!--REF ...--> / <!-- END REF--> comment markers used by the 4D docs build system were intentionally left untouched even on lines that were otherwise edited.
  • No files outside i18n/ja/docusaurus-plugin-content-docs were modified.

miyako and others added 5 commits July 30, 2026 15:50
Corrects definite translation/conversion errors in the Japanese (ja)
localization of commands-legacy docs, verified against the English
source (docs/ or versioned_docs/version-21/):

- Duplicate particles (nono, nikara, nide) in current/, version-21-R3/,
  version-21-R4/, and version-21/, e.g. "DIGESTモードのの例題" ->
  "DIGESTモードの例題", "始めにで再利用する" -> "始めに再利用する",
  "SCRIPTにからメソッド" -> "SCRIPTからメソッド". Includes the repeated
  "developer.4d.com でのの" template error across 9 Blob-related files.
- Broken katakana terms caused by hard line-wrap conversion, found only
  in version-21/ (~48 files), e.g. "ヘッ ダー" -> "ヘッダー",
  "データベー ス" -> "データベース", "カレント セレクション" ->
  "カレントセレクション". Verified each against the dominant no-space
  convention used elsewhere in the same files to avoid false positives;
  legitimate two-word boundaries (e.g. "モード デフォルト値",
  "マイ ドキュメント", "シングルユーザー プロジェクトデータベース",
  "シリアルポート バッファーサイズ") were left untouched.
- A corrupted "にからの文字列" in get-print-option.md (version-21),
  restored to "*value2*に空の文字列" matching the English source and
  the file's own established phrasing for empty-string arguments.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
on-host-database-event-database-method.md (current/, version-21-R3/,
version-21-R4/, version-21/) incorrectly linked to the Semaphore command
in the constants table, where the English source clearly refers to the
On Exit database method and On Startup database method instead. Verified
against docs/commands-legacy/on-host-database-event-database-method.md
(and versioned_docs/version-21 for the v21 copy).

Also restored two entirely missing links in the same table rows ("On
after host database startup" and "On before host database startup"),
which referenced "データベースメソッド" without any link at all, and
fixed a stray "ホストデーターベース" typo (extra long-vowel mark) picked
up in the same row.

Other [Semaphore] references in on-server-shutdown-database-method.md
and on-startup-database-method.md were verified as correct (the English
source does recommend the Semaphore command there) and were left
unchanged.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Adds cross-references that exist in the English source but were dropped
from the Japanese translation, applied consistently across current/,
version-21-R3/, version-21-R4/, and version-21/ where each file exists:

- on-mobile-app-authentication-database-method.md: the "See also" list
  was missing the "[Go Mobile with 4D]" link entirely (an empty line
  was left in its place).
- on-exit-database-method.md: "awakes processes that have been delayed
  by DELAY PROCESS or other means" had lost the DELAY PROCESS link,
  leaving a vague "コマンドや他の手段によって" with no command named.
- on-web-legacy-close-session-database-method.md: the sentence about
  reusing saved session data did not mention where it is reused (the
  English source specifies "more specifically using the On Web
  Connection [database method]"); added that reference.
- on-backup-shutdown-database-method.md: "On Backup Startupデータベース
  メソッド" was plain text instead of a link to
  on-backup-startup-database-method, unlike the equivalent English link.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Applies the long-vowel mark convention (JIS Z 8301, used for Japanese
loanwords ending in "-er"/"-or"/"-ar") consistently for "browser" across
current/, version-21-R3/, version-21-R4/, and version-21/
commands-legacy docs.

ブラウザー was already the dominant spelling (20 files) versus the
inconsistent ブラウザ (34 files); this bulk change makes usage uniform.
Applied via `perl -pe 's/ブラウザ(?!ー)/ブラウザー/g'` (negative
lookahead to avoid doubling existing ー). Verified no ブラウザーー
doubling was introduced.

This is a separate, easily revertible commit as it's purely editorial
terminology standardization rather than a correctness fix.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Applies the JIS Z 8301 long-vowel mark convention for "folder" across
the entire i18n/ja/docusaurus-plugin-content-docs tree (current/,
version-18/, version-19/, version-20/, version-21/, version-21-R3/,
version-21-R4/), matching the already-dominant フォルダー spelling
(627 files) over the inconsistent フォルダ (437 files).

Applied via `perl -pe 's/フォルダ(?!ー)/フォルダー/g'` (negative
lookahead to avoid doubling existing ー). Verified no フォルダーー
doubling was introduced and no files outside i18n/ja were touched.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@miyako
miyako merged commit 7da2c71 into main Jul 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant