docs: how-to 20本の英語版を作成し EN/JA ロケールを正す (#761) - #762
Merged
Conversation
docs/how-to/（英語ロケール）に日本語で書かれていた how-to 20本を是正する。 - 日本語20本を docs/ja/how-to/ へ移設（JA ロケール確定） - docs/how-to/ に英語版20本を新規作成（コードは保持、散文・コメントを英訳） - concurrency-patterns の field-trials 内部リンクを移設後の深さに調整 （JA: ../../field-trials、EN: ../field-trials） - EN/JA サイドバーを4グループ（基本/パターン/I-O/テスト・リリース）に再編 これで英語話者も20本のガイドを正しいロケールで読める。sidebar 網羅チェック・ dead-link 検出ともに通過。 Closes #761 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
1 participant
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.
概要
「翻訳を作っておいて」を受けた対応。調査の結果、
docs/how-to/（VitePress の英語ロケール）に日本語で書かれた how-to が20本置かれていた（FT 由来）。英語話者にはロケールが誤っており、docs/ja/how-to/には対応が無かった。正しい二言語構成に是正する。対応
docs/ja/how-to/へ移設（JA ロケール確定）docs/how-to/に英語版20本を新規作成（コードブロックは保持、散文とコード内コメントを英訳）concurrency-patternsの field-trials 内部リンクを移設後の深さに調整（JA../../、EN../）対象: api-versioning, async-use-case, background-tasks, concurrency-patterns, cors, custom-auth-middleware, decimal-unicode-input, dependency-injection, domain-events, email-address-parsing, file-upload, lifespan-and-app-state, middleware-stack, problem-details, response-patterns, soft-delete, streaming, structured-logging, validation, webhook
検証
python3 scripts/check_docs_nav.py→ OK（全 Diátaxis ページがナビにある）npm run docs:build（dead-link 検出 ON）→ exit 0これで英語話者も20本のガイドを正しいロケールで読める。コードは無変更。
Closes #761
🤖 Generated with Claude Code