Team Hayes（Ajayaditya Lokchandra, Nithisha Venkatesh）です。私たちはインドから自動運転AIチャレンジ2026 に参加しています。日本語は読めません。この記事では、日本語が読めないチームが大会で困ったことと、それを次のチームが困らないように、ドキュメントとツールを英語対応した内容をまとめます。
英語版は後半にあります。 / English version below.
何に困ったか
大会のドキュメントは日本語と英語の両方で書かれていますが、2026 年に新しく追加されたページの多くは日本語だけでした。特に困ったのは、いちばん大事な時期に読むページです。
- SIM決勝・実機決勝の特設ページ: 集合時刻（試合の 40 分前、遅刻は不戦敗の可能性）、台上での役割、試合の流れ
-
SIM決勝の PC 環境説明: 持ち込み PC の固定 IP や
ROS_DOMAIN_IDの設定。間違えると当日 AWSIM とつながらない - 実車両の操作・ECU・遠隔操作のページ: 緊急停止や手動復帰の手段になるコントローラの準備
英語サイトでは、英語版がないページは日本語のまま表示されます。ブラウザの翻訳で読むことはできますが、翻訳ではコマンドや数値が崩れることがあり、「本当にこの意味で合っているか」を確かめる手段がありません。
もう一つは、ツールの出すメッセージです。topic_check.sh が「必須トピックの一部が見つかりません。」と出したとき、日本語が読めないと、何が失敗したのか分かりません。
やったこと
| 内容 | 件数 | PR |
|---|---|---|
| 日本語のみのページの英訳 | 11 ページ以上 | docs #77 #78 #79 #80 #81 #82 #99 #100 など |
| ツールのメッセージを日本語と英語の併記に | 21 か所・7 ファイル | racingkart #338 |
| 決勝の流れの図（ラベルが画像内の日本語）を英語の手順として追記 | 2 図 | docs #77 |
| 提出方法ページのスクリーンショットに代替テキスト | 13 枚 | docs #103 |
| 用語集（走行枠、反則、BLOCK、ハンディキャップなど 25 語）と海外参加者向けガイド | 2 ページ（日英） | docs #104 |
すべてのプルリクエストがマージされると、ドキュメントのすべてのページが日本語と英語の両方で読めるようになります。
翻訳で気をつけたこと
- 意味を変えない: 翻訳の PR では内容の追加や修正はせず、日本語版の意味をそのまま英語にしました。日本語版に矛盾や誤字を見つけた場合は、PR の本文に書いて運営の判断に任せています。
-
コマンド・数値・アンカーはそのまま: IP アドレス、コマンド、見出しのアンカー（
{ #s2r-flow }など）は日本語版と同じにしました。アンカーが同じなら、日本語版へのリンクがそのまま英語版でも使えます。 - ルールは元のページが正: 用語集のルールに関わる説明は、ルールページの文言に合わせ、リンク先を正としています（例: BLOCK は 20 秒間 5 km/h の速度制限）。
-
ビルドの警告を増やさない: どの PR も
mkdocs buildの警告数を確認し、増やさないようにしました。英語版が別の PR にあってまだリンクできないページは、サイトの URL にしてあります。
アクセシビリティ
翻訳だけでなく、画像の中身を読めない人のことも考えました。提出方法のスクリーンショット 13 枚には alt 属性がなく、スクリーンリーダーでは何も読み上げられませんでした。各画像に「何が写っていて、どこを指しているか」の説明を付けています。決勝の流れの図も、ラベルが画像の中にあるため、同じ内容を文章の手順として図の下に置きました。
次に参加する海外チームへ
- まず 海外参加者向けガイド と 用語集 を読んでください（#104 のマージ後に公開されます）。
- 質問は英語で大丈夫です。Slack の質問チャンネルでも、GitHub の Issue でも受け付けてもらえます。
- 日本語のページはブラウザの翻訳で読めますが、コマンドとファイル名は書かれたとおりに使ってください。
作り方について
翻訳とこの記事の作成には AI コーディングエージェントを使いました。翻訳はすべて日本語版と一文ずつ照合し、コマンド・数値・リンクは元のページと同じであることを確認しています。自然でない表現があれば、各 PR でご指摘ください。
English
Team Hayes (Ajayaditya Lokchandra, Nithisha Venkatesh). We are a team from India in the JSAE AI Challenge 2026, and we do not read Japanese. This is what got in our way as a non-Japanese team, and what we changed in the documentation and tools so the next team does not hit the same walls.
What got in the way
The documentation is written in Japanese and English, but many pages added in 2026 were Japanese-only, and they were the pages that matter most at the most important time: the SIM and real-vehicle finals pages (call times, 40 minutes before your match, where being late can mean a forfeit; on-stage roles; match flow), the SIM finals PC guide (the static IP and ROS_DOMAIN_ID for a bring-your-own PC, which if wrong means no link to AWSIM on the day), and the real-vehicle pages (operation, ECU setup, and the remote controller that is your emergency-stop and recovery channel). The English site shows the Japanese page when there is no English one. Browser translation helps, but it can mangle commands and numbers, and you cannot check whether the meaning is right. Tool messages were the other problem: when topic_check.sh printed 「必須トピックの一部が見つかりません。」, a non-Japanese reader could not tell what had failed.
What we did
See the table above: English versions of 11+ Japanese-only pages; 21 tool messages in 7 files made "Japanese / English"; the two finals flow diagrams, whose labels are Japanese text inside the images, written out as English steps; alt text for 13 submission-page screenshots; and a 25-term glossary plus a guide for international participants. Once the PRs merge, every page of the documentation is readable in both languages.
How we translated
We did not change meaning: translation PRs add no new content, and anything odd in the Japanese source is noted in the PR for the organisers to decide. Commands, numbers, IP addresses and heading anchors (such as { #s2r-flow }) are identical to the Japanese page, so links keep working in both languages. Rule-related glossary entries follow the rules pages' wording, and the linked rules are authoritative (for example, BLOCK is a 20-second 5 km/h speed limit). Every PR was checked to add no mkdocs build warnings.
Accessibility
The 13 submission-page screenshots had no alt attribute, so a screen reader said nothing about them; each now describes what it shows and what it points at. The finals flow diagrams keep their labels inside the images, so the same steps now also appear as text below each diagram.
For the next international team
Start with the guide for international participants and the glossary (live once #104 merges). Asking in English is fine, in the Slack question channel or as a GitHub issue. Browser translation is fine for reading Japanese pages, but use commands and file names exactly as written.
How this was made
We used AI coding agents for the translations and this article. Every translation was checked sentence by sentence against the Japanese page, and commands, numbers and links were confirmed identical to the source. If any wording reads unnaturally, please say so on the PR.
Team Hayes の自動運転AIチャレンジ2026 シリーズ / series
- 最近傍 waypoint の argmin が 1.5 m で逆向きの区間に飛ぶ / argmin snaps to the opposite leg
- v_max を下げたら速くなった / Lowering v_max made it faster
- quaternion の z を yaw だと思っていませんか / quaternion z is not yaw
- make eval が止まる・提出物が入れ替わる: スターターキットの罠と PR / starter-kit traps and fixes
- AI エージェント 100 体で学んだこと / Lessons from 100 AI agents
- 日本語が読めなくても参加できるように: ドキュメントとツールを英語対応 / Making the challenge readable without Japanese
- ツール集 / toolkit: aichallenge-toolkit