Skip to content

AI assisted prose check on JA (and some EN) legacy docs - #3360

Merged
arnaud4d merged 15 commits into
doc4d:mainfrom
EmikoToda:main
Jul 31, 2026
Merged

AI assisted prose check on JA (and some EN) legacy docs #3360
arnaud4d merged 15 commits into
doc4d:mainfrom
EmikoToda:main

Conversation

@miyako

@miyako miyako commented Jul 31, 2026

Copy link
Copy Markdown

No description provided.

miyako and others added 15 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>
Fix Japanese docs: typos, cross-refs, missing links, terminology
- Fix misspelled link slugs: sempahore → semaphore, clear-sempahore → clear-semaphore
- Fix truncated link slug: ction-info → action-info
- Fix truncated link slug: set-quer-destination → set-query-destination
- Fix typo in code comment: modfiy → modify
- Fix malformed admonition syntax: ::info → :::info
- Replace French word 'encodage' with proper English in XML example

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
- Fix SAX acronym: 'Simple API XML' → 'Simple API for XML'
- Fix org name: 'Apache Foundation company' → 'Apache Software Foundation'
- Fix XSL definition: 'contents of an XSL document' → 'contents of an XML document'
- Fix tab character and missing space in Markdown table
- Remove orphan admonition wrappers around plain text paragraphs
- Fix awkward phrasing: 'provoke errors' → 'cause errors'

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
The subtraction operator was lost during HTML-to-Markdown export.
Original confirmed at library.4d-japan.com/doc/4Dv20.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Fix documentation quality issues in legacy docs (Desktop-legacy, Develop-legacy, language-legacy)
- Fix フィ-ルド (wrong character U+FF0D) → フィールド (correct U+30FC) across 53 files
- Standardize トリガ → トリガー (preferred term)
- Fix ユーザインターフェース → ユーザーインターフェース
- Fix grammar: 使用してないでください → 使用しないでください
- Fix して下さい → してください (consistent hiragana)
- Fix broken bold markup: **インスペクタ**ー → **インスペクター**
- Remove stray period and empty 注: markers
- Fix word-wrap space artifacts from HTML export

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Fix documentation quality issues in legacy docs (English + Japanese)
@arnaud4d
arnaud4d merged commit 521b52f into doc4d:main Jul 31, 2026
22 checks passed
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.

2 participants